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PREFACE 



MANUAL OBJECTIVES 

The SPM-1 1M-PLUS Reference Manual is a manual describing the 
structure and use of the SPM- 1 1M-PLUS software supported by 
DIGITAL on RSX-11M-PLUS operating systems. 

INTENDED AUDIENCE 

This manual is for all users of SPM-11M-PLUS. 



STRUCTURE OF THIS DOCUMENT 

Chapter I is an overview of the architecture of SPM - 1 1M- PLUS 

Chapter 2 describes the components of S PM- 1 1M-PLUS . 

Chapter 3 describes how to use SPM-1 1M-PLUS , 

Chapter 4 describes data collection and reduction procedures, 

Chapter 5 describes how to read the performance report. 

Chapter 6 delineates the resources used by S PM- 1 1M- PLU S . 

Chapter 7 is the usage notes for SPM- 1 1M-PLUS . 

Appendix A is a specification of the Hook Records, 

Appendix B is a specification of the Monitor Parameter Block 
(MPB) . 

Appendix C is a specification of the Information Records. 

Appendix D is a specification of the System Metrics Record. 

Appendix E is a specification of the logfile format. 

Appendix F is a sample performance report. 

Append i x G i s a sample SMPGEN.CMD procedure. 

Appendix H is a sample installation. 
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CHAPTER 1 
OVERVIEW OF 
SPM-1 1M-PLUS 



The Software Performance Monitor ( SPM- 1 1M-PLUS) is a software 
instrument used to measure the performance of a computer system 
running the RSX-11M-PLUS operating system . 

SPM- 1 1M-PLUS is a natural counterpart to RSX- 1 1M-PLUS : while 
RSX-11M-PLUS manages the resources of the computer system , 
SPM-11M-PLUS remembers how the resources were used over a 
period of time, similar to the way a tape recorder remembers a 
set of sound patterns . Moreover , SPM- 1 1M-PLUS has the capa- 
bility of " pi ayi ng back" these record i ngs of resource usage , so 
an analyst can study how and when the resources were used. 

SPM- 1 1M-PLUS is an event driven performance monitor. As each 
event of interest occurs , the performance monitor is called. 



1.1 RESOURCES 

The key resources of i nterest are: 






CPU 







Ma i n 


memory 





I/O 


devices 





File 


system 





Task 


loader 



Note that a resource can be a hardware resource -- such as the 
CPU, main memory or an I/O device; or a sof twa re resource 
such a s the file system or the task loader. 
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1.2 USERS 



A user is the entity which uses the resources managed by the 
operating system. We define a user to be an RSX-11M-PLUS task . 
Uf primary concern is the workload the task pi aces on the 
system, that is, how much and for how long the resources are 
used. To descri be a task's workl oad we will define a set of 
metrics for resource usage . 



1.3 RESOURCE MODEL 

Because a number of tasks may concurrently request the use of a 
resource , and only one task may use the resource at a time , a 
queue wi 1 1 form for the resource. A simpl e queued resource is 
depicted as follows,: 




The vertical bars represent the queued resource requests and 
the square represents the resource. Three i nterval s are shown 
on the diagram. "W" denotes the interval during which a task 
is waiting for the resource. "U" denotes an interval when a 
task l s using the resource . "S" is the sum of "W" and "U" 
called the service time. 



1.4 EVENTS 

The acti vi ty of the RSX-11M-PLUS operating system can be traced 
by defining a set of key events and recordi ng a set of raw 
i nf ormati on associated with each event . The events of i nterest 
are those which capture the metrics of resource usage. 

For exampl e , we may want to know how long a task waits for the 

disk, how many times it uses the disk and how long it uses the 

disk. The f ol 1 owi ng events are defined to capture the I/O 
acti vi ty : 

1. Queue I/O packet to driver 

2. Driver gets I/O packet 

3. Driver posts I/O completion 
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Applied to the queued resource model for the disk, these I/O 
events appear as follows: 



1 2 3 

The complete set of events defined for RSX-11M-PLUS is 
speci f i ed in Append i x A . 



1.5 TASK METRICS 

The task metrics quantify the workload that individual tasks 
place on the system. 

The task metrics are computed for a 1 1 three types of interval s : 
U , W and S . The performance report will contain a line of task 
metri cs for each resource used by the task. The task metrics 
are: 

o Count 

A simple metric for resource usage is a count of the 
number of times the resource was used during the life 
of a task . For exampl e , if a task does four Q I Os to a 
disk , the I / request count is four. 

o Total Ti me 

Another simple metri c is how long the task uses a 
resource . For exampl e , if a task did four Q I Os and 
the I/O requests took 20ms , 60ms, 10ms and 50ms to 
compl ete , the total usage time woul d be 140ms . 

o % Resi dent Time 

Also of importance is what percentage the total usage 
time is of the time the task was in memory . For 
example 3 if the previous task was in memory for one 
second the percentage of resident time spent using the 
disk was 140ms/1000ms *100% = 14%. 
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o Interval Stati sti cs 

The stati sti cal nature of the usage time is of key 
i mportance . 

The metrics defined for interval statistics are : 

Minimum interval 

Mean (average) interval 

Maximum interval 

- Coefficient of Variation 

The coef f i ci ent of variation is the standard devi ati on 
of the i nterval s di vided by the mean interval. 

The coefficient of vari ati on is of particular impor- 
tance because it tells whether the data is cl ustered 
about the mean ( sma 1 1 c.v.) or widely scattered about 
the mean (large c.v.). I n fact , if the c.v. is 1 arge , 
the mean may tell very little about the nature of the 
data , since very smal 1 values and very large values 
may combi ne to produce a mean which is not represen- 
tat i ve of any real value. 



1.6 SYSTEM METRICS 

The task workload metrics defined above are useful for deter- 
mining who is using the system resources and how much each user 
is consumi ng . 

Also of importance is the performance of the system as a whole. 
To this purpose we define a set of system met r i cs . 

The system metri cs vary a s a function of time. To see how a 
given system metric varies with time , hi stograms are computed 
for the metri c . Each hi stogram descri bes the per cent usage of 
a resource for one sampling interval . The sampl i ng i nterval is 
a settabl e parameter described in Chapter 3, section 3.2.1. 



CPU 



The CPU can be in one of three general states : 



o 



User 



o 



Kernel (system) 



o 



Idl e 



12/81 



OVERVIEW OF SPM-11M-PLUS 



1-4 



A useful metric is the per cent of time spent in each state, 
that i s : 

o % time in user state 

o % time in kernel state 

o % time in idle state 

This gives us a general picture of how effectively the CPU is 
being utilized ( % time in user state + % time in kernel state) , 
a s well a s the overhead imposed by the operating system ( % time 
in kernel state) . 

Memo ry 

On RSX-HM-PLUS the memory space is divided into partitions. 
The user can select one system-control 1 ed partition for 
monitoring by SPM- 1 1M-PLUS . The performance monitor will 
compute the per cent of the partition that was in use at the 
end o f each sampling i nterval and print a h i stog ram . 

The user wi 1 1 most common 1 y select the partition "GEN" for 
monitoring. 

I/O Devices 

The user can select one I / device to be monitored by 
SPM-11M-PLUS for system-wi de usage . SPM-11M-PLUS will compute 
the percent of time the device was utilized for each sampling 
interval and print a hi stogram. I f the device is mounted 
F i 1 e s - 1 1 , SPM-11M-PLUS wi 1 1 compute the percent disk space in 
use at the end of each sampl i ng interval and print a histogram. 

Primary and Seconda ry Pool 

The RSX-11M-PLUS system pool contai ns the dynami cal ly al 1 ocated 
data structures used by the execut i ve . SPM- 1 1M-PLUS wi 1 1 
compute the per cent of p r i ma ry pool and the per cent of 
seconda ry pool that was in use a t the end of each sampling 
interval and print a histogram for each . 

Checkpoi nt file(s) 

SPM-11M-PLUS will monitor checkpoint files allocated by the AC S 
command. The performance monitor will compute the per cent of 
all active checkpoint file space in use a t the end of each 
sampl i n g interval and print a histogram. 
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CHAPTER 2 
THE COMPONENTS 
OF SPM-1 1 M-PLUS 



The SPM-1 1M-PLUS performance monitor consists of two main 
components : the Data Collection Component and the Data 
Reducti on Component . The Data Collection Component records the 
resource usage events of the operating system to a logfile; the 
Data Reduction Component reads the logfile and produces a 
performance report suitable for analysis. 

This general archi tecture is depicted in Figure 1 . 




Data 
Collection 
Component 



iOi 



LogFile 



Data 
Reduction 
Component 



Performance 

Report 



Figure 1 
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By decoupling the Data Collection Component from the Data 
Reduction Component in time, the performance monitor can 
collect detai 1 ed i nf ormati on about a huge number of events, 
albeit in a raw format. The Data Reducti on Component can then 
be used to selectively analyze and filter the i nformati on in 
the logfile to produce a performance report. This architecture 
shifts the computational aspects of the performance moni tor 
from the Data Col 1 ecti on Component to the Data Reduction 
Component. The benefit derived is that the performance monitor 
uses less CPU time , thus minimizing its i nterf erence with the 
CPU. The cost is more I/O acti vi ty , which in most systems can 
be d i rected to a secondary mass storage device not in the path 
of the major stream of I/O activity. 



2.1 DATA COLLECTION COMPONENT 

The Data Collection Component consists of both software and 
hardware di stri buted in various places within an RSX-11M-PLUS 
system. 

The basic pieces of the Data Collection Component are : 
o Hooks 

o Hook Dispatcher 

o Hook Routines 

o Hook Records 

o KW11-P Clock and Handler 

o Hook Buffers 

o Logfile 

o Data Col 1 ecti on Task (...COL) 
o Termi nation Tas k ( . . . TRM) 
o COL Message Task (COLMSG) 



The relationship between these pieces is shown in Figure 2. 
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DATA COLLECTION COMPONENT 




BUFFER 
PARTITION 



Hook 
Record 




LOGFILE 



Figure 2 



Heuristic Procedure for Data Collection 

At this point a heuristic procedure for data collection will be 
given, al though the terms used in the procedure have not been 
precisely defined. 
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When a resource usage event occurs in RSX-11M-PLUS , the corre- 
sponding hook calls the hook di spatcher , which uses the hook ID 
to call the appropriate hook routine. The hook routine 
collects information relevant to the hook and assembles it into 
a hook record, which resides in a hook buffer. When a hook 
buffer is filled with hook records, it is written to the 
logfile. The logfile is closed at the end of the measurement 
interval, and subsequently reopened by the Data Reduction 
Component. It reads the hook records and uses them to derive 
the resource usage metrics and print a performance report. 

The detail s of these pi eces will now be devel oped more fully. 



2.1.1 Hooks 

A hook is simply an implementation technique for capturing a 
resource usage event . For SPM-11M-PLUS , a hook is implemented 
as a subroutine call inserted at the point in the operating 
system where the event occurs . The subrouti ne call passes 
control and one argument, the hook ID, to the hook dispatcher. 
The form of an S PM- 1 1M-PLUS hook is as fol lows : 



where XXXX is mnemoni c i denti fyi ng the particular hook. A 
complete specification of all hooks is given in Appendix A. 



2.1.2 Hook Dispatcher 

Hooks are resident within the operating system ; their method of 
i nserti on is addressed in Chapter 3, section 3.1.3. However , 
most of the code and database for the Data Collection Component 
is not resi dent within the RSX-11M-PLUS executive. 

The bulk of the data col 1 ecti on code is resident in the data 
collection task called COL (taskname is ...COL). The chief 
benefit derived from this design is that only a small amount of 
executive space is used by the performance monitor. 

The purpose of the hook dispatcher is to map and call the hook 
routines which are resident in the COL task. Note that, though 
the hook routines are resident in the task partition for COL, 
they are executed in the context of a directive or interrupt 
serviceroutine. 
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MOV 
MOV 
CALL 



@#PS ,-(SP) 

#H$XXXX,-(SP) 

@$HKDSP 



A one word dispatch vector labelled $HKDSP is added to the 
modul e DRTBL. Thi s word points to an entry point in the hook 
dispatcher . It is the port through which all hooks pass 
control from the RSX- 1 1M-PLUS executive to the Data Col 1 ecti on 
Component of the performance monitor. 



2.1.3 Hook Routine 

A hook routi ne copi es information which is general ly scattered 
about the executive (typical ly in SYSCM or SYSTB) into a hook 
record which is resident in a stati c common or dynamic region. 
A timestamp is also recorded in the hook record . 

There are two general types of hooks : task and system. The 
task hooks collect data relevant to resources used by tasks ; 
the system hooks collect data which is system-wi de (e.g. , % CPU 
time in user , kernel and idle). 



2.1.4 Hook Record 

The i nf ormati on collected at each hook is formatted into a hook 
record . The hook record provides an i denti cal representation 
of a hook's i nf ormati on content both in memory and in the 
1 ogf i 1 e . 

Each hook record contains both generic and hook-speci f i c data . 
Generi c data applies to all hooks . Generi c data consists of : 

o Hook ID 

o Taskname 

o Ti mestamp 

o Task ' s TI (UCB address) 

Hook specific data applies to on 1 y one or a small subset of the 
hooks . For example, the H$CDRP (call di recti ve processor) hook 
records the directive I D code a s hook-speci f i c data . 

Append i x A speci f i es the information content of the hook 
records . 
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2.1.5 KW11-P Clock and Handler 



For precise performance measurements, SPM- 1 1M-PLUS needs a high 
speed clock runni ng i ndependent of the RSX-11M-PLUS system 
clock. It is therefore a requirement that a KW11-P clock be 
installed on a machine runni ng SPM-1 1M-PLUS . Thi s KW11-P clock 
must be in addition to the RSX-1 1M-PLUS system clock, be it a 
KW11-L or KWll-P. 

The KWll-P is initialized by the COL task to run at 100 kHz 
(10 microsecond ticks) and to interrupt every 65536 ticks 
(approximately every 0.65 second). 

The KWll-P clock time is mai ntai ned as as 2 word (32 bit) value 
which, at a rate of 100 kHz , wi 1 1 overf 1 ow in a little over 
11 1/2 hours. 

To precl ude the possibi 1 i ty of overf 1 ow of the KWll-P clock 
time, a maxi mum measurement i nterval of 1 1 1/2 hours has been 
establ i shed. The task COL enforces this by setting an 11 1/2 
hour mark-time when activated. If the timer expi res , COL wi 1 T 
stop data collection and exit. 

The clock interrupt handler updates the high order clock time 
located in SYSCM at $PCLKH. The low order clock time is not 
stored in memory; rather, each hook routine copies the current 
contents of the KWll-P clock's count register to the hook 
record di rectly to get the low order time word. 



2.1.6 Hook Buffer 

Hook records are stored in buffers which are resident in either 
a static common or a dynami c region. When a hook buffer is 
full, the hook routine sets an event flag whi ch signals the COL 
task to write the buffer to the 1 ogf i 1 e . 

The hook buffers are 1 i nked together into a circular list. 
There may be from 2 to 8 buffers in a list, and all the buffers 
must be of the same length. A buffer may be from 256 words to 
4096 words long. 

If the buffers are resident in a static common, the maximum 
size common which can be used is 4096 words. This limitation 
is imposed because the COL task uses one APR to mao the static 
common . 

If the buffers are resident in a dynamic region, the region can 
be from 512 words to 32K words long. 
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2.1.7 Logfile 

The logfile contains four types of records: 

o Monitor Parameter Block ( M P B ) 

o Information Records 

o Hook Records 

o System Metric Records 
See Appendix E for a specification of the logfile. 



Monitor Pa rameter Block 

The Monitor Parameter Block (MPB) is used by the COL task to 
initialize its measurement parameters. The MPB is formatted as 
an Information Record with record type I $MPB . A detailed 
descri pt i on of the MPB is given in Append i x B . 

The MPB is generated by a command file called SMPGEN.CMD. See 
Chapter 3 , section 3.2.1 for details. 



Inf ormati on Record s 

The In format i on Records are used to suppl ement the Hook Records 
in the logfile with system context useful to the Data Reducti on 
Component . 

When COL starts up it reads the MPB from the MPB file and 
writes it to the logfile. Following the MPB, COL writes a 
stream of Information Records which contain a number of 
RSX-11M-PLUS data structures defining the initial system state . 
These data structures are: 

o Task Control Block (TCB) 

o Partition Control Block (PCB) 

o Device Control Block ( DC B ) 

o Unit Control Block (UCB) 

Each data structure is copied to a separate Informati on Reco r d . 

When COL begins a measurement interval (starts data col lec- 
tion) , it records the RSX-11M-PLUS system time as well a s the 
SPM-11M-PLUS time (KW11-P time) to an Information Record 
( I $ T M R ) . 
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When COL ends a measurement interval (stops data collection) it 
copies the RSX-11M-PLUS system time , SPM- 1 1M-PLUS time , CPU 
time accrued in kernel state and CPU time accrued in idle state 
to an Information Record (I$STM). 

A complete specification of all Information Records is qiven in 
Appendix C. 



Hook Records 

As each hook point is encountered in the executive, a Hook 
Record is written to the logfile. See secti on 2.1.4 for 
details. 



System Metrics Record 

At the end of each sampl e interval , a System Metrics Record is 
written to the logfile. Thi s record contains i nformati on which 
describes the system-wi de usage of the selected resources . 

The System Metri cs Record is speci f i ed in Appendi x D. 



Logfile Media 

The logfile can be resident on disk as a F i 1 e s - 1 1 file or on 
magtape as a sequence of tape records . 

If the logfile is resident on disk, it consists of a sequence 
of vi rtual bl ocks (virtual bl ock = 256 words ) . The records 
within these vi rtual blocks are defined according to the record 
definitions for the MPB , Information Records, Hook Records and 
System Metri c Records. Note that the logfile does not have any 
other record structure (such as FCS or RMS type records) . 

If the logfile is on a magtape , the MPB , Information Records 
and Hook Records are i mbedded in a stream of tape records . 
Each tape record is equal in 1 ength to a hook buffer. 



2.1.8 Data Col 1 ecti on Task (...COL) 

This section gives a functional description of the COL task. A 
guide to using COL is provided in Chapter 3, section 3.2.2. 

As noted before, this task contains both code which executes in 
executive context (as a directive or interrupt process) and 
code which executes in the context of a privileged task. The 
code which executes at executive level is the hook routines. 
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2.1.8.1 COL Executive Level Code - 

The hook routines were made a part of the COL task for a number 
o f reasons : 

o They must be resident in some partition outside of 
executi v e space . 

o They can easily be loaded as part of the COL task . 

o They i mpl ement routines which are common to hooks and 
to the COL task . 



2.1.8.2 COL Task Level Code - 

Most o f the COL task consists of code which is executed at task 
level . The major f uncti ons of the COL task are: 

o Initialization 

o Starti ng data collection 

o Writing to logfile 

o Stoppi ng data col lection 

o C 1 eanup 

2.1.8.2.1 Ini ti al i zati on - 

When COL begins execution , there is very little SPM- 1 1M-PLUS 
code el sewhere in the system . Al 1 that exists are the hooks in 
the executive which all call a dummy return subroutine in 
TDSCH. It is the job of COL to initialize al 1 code and 
databases r e q u i red for the SPM-11M-PLUS performance monitor. 
The speci f i c sequence of initial i z a t i o n functions performed by 
COL are : 

o Read MPB file and store MPB in COL buffer. 

o Create dynami c region (if necessary) and set up ring 
of hook buffers . Mark dynami c regi on or static common 
as fixed and non-shuf f 1 able. 

o Write MPB and Information Records ( RSX- 1 1M-PLUS data 
structures ) to logfile. 

o Mark COL task as fixed in memory and nonshuf f 1 abl e. 

o Initialize hooks specified in MPB. 
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o Initialize KW11-P clock and turn it on . 

o Initialize measurement parameters as speci f ied in MPB. 



2.1.8.2.2 Starting Data Collection - 

When data collection is disabled, the hook dispatch vector 
$HKDSP points to the entry point $HKEXT in the hook 
dispatcher, which simply returns to the instruction in the 
executive following the hook. 

Just prior to starti ng data collection, COL writes a "start 
data collection" Informati on Record ( I $TMR ) to the hook buffer. 

To enable data col lection the COL task simply points the hook 
dispatch vector $HKDSP to the entry point $HKENT in the hook 
dispatcher. 

2.1.8.2.3 Writing Hook Records to Logf i 1 e - 

The steady state function of the COL task is to write Hook 
Records to the 1 ogf i 1 e. When a hook routine fills a hook 
buffer, it sets an event flag for COL whi ch wakes COL from its 
wai t state . COL then writes the hook buffer to disk or magtape 
(wai ti ng for compl eti on of the write) , and 1 oops to see if 
another hook buffer is ready to write. When no more hook 
buffers are outstanding, COL returns to the wai t state . 

If the hook buffers fill up too rapidly for COL to write them 
to the 1 o g f i 1 e , COL will set the overf 1 ow status bit. If the 
overflow status is set when a measurement i nterval expi res , COL 
will print a status message on the console device (CO : ) . In 
general, the data coll ected during a measurement i nterval 
should not be used for data reducti on if the overflow condition 
occurred . 



2.1.8.2.4 Stopping Data Collection - 

To stop data col 1 ecti on , COL merely points the hook dispatch 
vector $HKDSP to the dummy routine at $H KE XT in the hook 
di spatcher . It then writes a stop data collection Informati on 
Record (I$STM) to the hook buffer. Any outstandi ng records in 
the hook buffer will be written to the 1 ogf i 1 e . 
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2.1.8.2,5 Cleanup - 



Before COL exits , it must release any system resources it has 
allocated and deactivate any hardware it has turned on. The 
following actions are thus performed: 

o Turn off KW11-P clock. 

o Unfix COL task. 



2.1.9 Termination Task (...TRM) 

The purpose of the termination task (...TRM) is to signal the 
COL task to stop data collection and exit. TRM provides a way 
to manually terminate the COL task, as opposed to automatic 
shutoff by timeout or buffers (see Chapter 3, section 3.2.1). 



2.1.10 COL Message Task (COLMSG) 

The COL message task contains the ASCII text for the error 
messages issued by the COL task. I f the COLMSG task is i n s t a 1 - 
led and a COL error occurs, the full error message text will be 
printed. If a COL error occurs and the COLMSG task is not 
i nstal 1 ed , the COL task will print an error n umber which can be 
correlated with the correct error message in Chapter 3 , section 
3.2.2. 



2.2 DATA REDUCTION COMPONENT 

The main purpose of the Data Reduction Component is to read the 
raw data from the logfile (hook records) and produce a perfor- 
mance report deta i ling the resources used by the various tasks 

in the system. 

The Data Reduc t i on Component accompl i shes this in a multi-step 
process involving two tasks: 

o Monitor Data Reduction (MDR) Task 

o DRS Task 
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There are three major steps i n the data reduction process ; 

1. Map Hook Records to Task Wo rkl oad Records and generate 
system-wi de metrics secti on of performance report (MDR 
Pass 1). 

2. Sort Task Workload Records (DRS) . 

3. Summa r i ze Tas k Workload Record s and generate task 
metrics section of performance report (MDR Pass 2). 

The Task Workload Record s are i ntermedi ate data structures 
which contain the data col 1 ected for each task and each 
resource used by the task . 

Thi s general procedure is depicted in Figure 3. 



DATA REDUCTION COMPONENT 



TRACE . LOG 



""TJooF" 

Record 




RESOURCE. TMP 



Task Workload 
Record 





Figure 3 
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From the figure we see there are four databases which are 
processed by the two tasks : 

o TRAC E . LOG (logfile contai ni ng Hook Records ) . 

o RESOURCE . TMP ( i ntermedi ate file containing unsorted 
Task Workload Records) . 

o RESOURCE . SRT (intermediate file containing sorted Task 
Wor kl oad Records . 

o REDUCE . RPT (final performance report) . 



2.2.1 MDR Pass 1 

MDR reads hook records from the logfile (default name is 
TRAC E .LOG) and maps the information to the Task Workload 
Records in the intermediate file RESOURCE . TMP . 



2.2.2 DRS Pass 

DRS sorts the Task Workload Records using the following three 
keys : 

o Gene r i c Taskname 

o Task 1 s TI UCB address 

o Task start t i me . 



NOTE : By "generic taskname" we mean the i nstal 1 ed taskname of 
a multiuser task . For example , the generic taskname for 
the task PIPT5 is ...PIP. I f the task is not multiuser, 
generic taskname is simply the run time taskname . 



The three keys 1 i s t e d above are concatenated into one "big" 
key , with the gener i c taskname forming the highest order part 
of the key , the Task's T I UCB address f ormi ng the middle order 
part of the key , and the Task start t i me f ormi ng the 1 ow order 
part of the key . The DRS task sorts a 1 1 the Task Workload 
Records using this one big key . With this techn i que the DRS 
task only needs to do one sort operation on the file 
RESOURCE. TMP. 
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When DRS is done sorting the Task Workload Records , the records 
will be arranged as follows: 

o All records with the same generic taskname will be 
clustered together. 

o Within a generic taskname cluster, all records with 
the same TI will be clustered together. 

o All records within a taskname-TI cluster will be 
sequenced by ascending task start time. 

!5 c s m ,^i te r s nT tne sorted Task Workload Records to the file 

KcbUUKL t . SRT , 



2.2.3 MDR Pass 2 



MDR reads the Task Workload Records from RESOURCE. SRT and 
generates a performance report. A description of the 
performance report is given in Chapter 5. 
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CHAPTER 3 
GUIDE TO USING 



SPM-1 1M-PLUS 



3.1 INSTALLATION 



3.1.1 SPM-11M-PLUS Kit 

The SPM-1 1M-PLUS kit is distributed on 800 BPI magtape. It 
conta i n s all the files necessary to i n s t a 1 1 and use 
SPM-11M-PLUS. The files are in DOS tape format . When copi ed 
to disk, the files will occupy approximately 900 disk blocks. 

The command file PM0NCPY.CMD can be used to copy the kit files 
from tape to tape , tape to disk , disk to tape or disk to disk. 
Al 1 files are contained in the di rectory [12,2]. The contents 
of the kit are: 

Component 

Kit copy command file 
SPM- 1 1M-PLUS mini - reference guide 
MPB GEN command file 
Macro def i ni ti on prefix file 
Executi ve source correcti on command file 
Executive source correcti on files 
F11ACP patch command file 
F11ACP patch source 
COL/TRM build command file 
COL overlay descri ptor file 
COL/TRM object 1 i brary 
MDR/CLF object library ( E I S version) 
MDR/CLF obj ect 1 i brary ( FPP versi on) 
MDR/C LF/OVL bui 1 d command file 
Data reduction sort task 
DRS map file 
DRS sort command file 
CLF task 
CLF map file 
OVL obj ect 1 i brary 
OVL task 
OVL map f i 1 e 



File 

PMONCPY.CMD 
SPM. DOC 
SMPGEN.CMD 
HKMAC . MAC 
PMONSLP.CMD 
*.C0R 

PMONPAT.CMD 
DISPAT.PAT 
PMONBLD.CMD 
COLBLD.ODL 
COL.OLB 
MDREIS.OLB 
MDRFPP.OLB 
MDRTKB .CMD 
DRS.TSK 
DRS. MAP 
DRS. CMD 
CLF .TSK 
CLF. MAP 
OVL.OLB 
OVL. TSK 
OVL. MAP 
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3.1.2 Prerequisites to Installing SPM-11M-PLUS 
COL Prerequisites 

The following are the prerequi sites for running the COL task : 
o Supervi sor-mode library support 

o The supervisor-mode library FCSFSL must be installed 
o Memory Management ( PLAS ) Di recti ves 

MDR Prerequi si tes 

Al 1 Prerequisites for MDR are included in a minimum 
functional ity RSX-11M-PLUS system. To run MDR at 1 east one 
system-wi de checkpoi nt file must be al 1 ocated using the ACS 
command . For MDR to automati cal ly spawn the task DRS , 
parent-offspring support must be included in the RSX-11M-PLUS 
executi ve . 

3.1.3 Installing SPM- 1 1M-PLUS 

To instal 1 SPM-11M-PLUS , you must start with : 
o An RSX-11M-PLUS VI. distribution kit 
o An RSX-11M-PLUS autopatch kit at the current level 
o An SPM-11M-PLUS di stri buti on kit 

To install SPM- 1 1M-PLUS you must perform an RSX- 1 1M-PLUS 
SYSGEN. A SYSGEN is requ i red because source code for 
SPM-11M-PLUS is i nserted into the RSX- 1 1M-PLUS sources . 
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SPM-1 1M-PLUS source code is added to the following RSX-11M-PLUS 
source modules : 

SPM-11M-PLUS Function RSX-11M-PLUS Modules 

SPM- 1 1M-PLUS Macros RSXMCO ,RSXMC 

and Definitions. 

Hooks DRDSP,DRQIO,DREIF ,DREXP , 

DRGIN ,DRTBL ,DRCRV ,REQSB , 
SYSXT , IOSUB ,L0ADR 

Additional Stack Space LOWCR 

Common Database SYSCM 

Hook Dispatcher TDSCH 

KW11-P CI ock Handler TDSCH 

For a complete example installation procedure , see Appendix H . 

The SPM-11M-PLUS i nstal 1 ati on procedure consists of the 
following steps: 

o Copy RSX-11M-PLUS VI. kit to baseline disk. 

o Perform autopatch to current level . 

Follow the instructions in the Autopatch notes for 
applyi n g Autopatch . 

Note : to run the Autopatch procedure , you must first 
invoke @[20U ,200 J SYSGEN and answer "yes" to the 
f o 1 1 owi n g quest i on : 

>* DO YOU WANT TO APPLY AUTOPATCH [Y/N]:Y 

When the Autopatch procedu re finishes, control will be 
returned to SYSGEN.CMD . You must then answer " NO" to 
the f o 1 lowing three questions: 

>* DO YOU WANT TO DO SYSGEN PART 1 [Y/NJ N 
>* DO YOU WANT TO DO SYSGEN PART 2 [Y/N] N 
>* DO YOU WANT TO DO SYSGEN PART 3 TY/Nl N 
>ASN = 
>@<E0F> 

When the SYSGEN.CMD procedure exits , continue to the 
next step . 

o Assign SY : to the baseline disk. 
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o Choose a directory to which you want the SPM- 1 1M-PLUS 
kit files copied . Thi s will be your SPM- 1 1M-PLUS kit 
di rectory. 

o Assuming the SPM-11M-PLUS directory is [g ,m] , and 
SPM- 1 1M-PLUS kit is physically mounted on device ddn :. 

>SET /UIC = [g ,m] 

>UFD SY :[g ,m] 

>M0U ddn :/F0R 

>FLX =ddn : [12, 2jPM0NCPY.CMD 
>(3PM0NCPY 

: { 



APPLY CORRECTIONS TO EXECUTIVE SOURCES? Y 



APPLY PATCH TO F11ACP DISPATCHER MODULE (DISPAT)? Y 
@<E0F> 
>DM0 ddn : . 
o Invoke SYSGEN.CMD a second time 

Invoke @[200 , 200jSYSGEN.CMD and answer "NO" to the 
f ol 1 owi ng questi on : 

>* DO YOU WANT TO APPLY AUTOPATCH [Y/N] N 

Then perform a SYSGEN by answeri ng "YES" to the 
f ol 1 owi ng questi ons : 

>* DO YOU WANT TO DO SYSGEN PART 1 [Y/N] y 
>* DO YOU WANT TO DO SYSGEN PART 2 [Y/N] Y 
>* DO YOU WANT TO DO SYSGEN PART 3 [Y/N] Y 
(Note: SYSGEN PART 3 is optional) 

NOTE: DO NOT PATCH F11ACP if you want to use the FC PRO 3 
version. 

If the patch to F11ACP fails (checksum error), 
SPM-11M-PLUS will only calculate service times for 
F11ACP. If the patch succeeds, SPM-11M-PLUS will 
generate usage, wait and service times. 



12/81 



GUIDE TO USING SPM-11M-PLUS 



3-4 



I f you d o not elect to correct the executive 
sources or patch Fl 1ACP via PMONCPY.CMD you can do 
s o later via the command files: 

1 ) @PM0NSLP for executive source corrections 

2) @PM0NPAT for F11ACP patch 



On systems with an FPU the f i 1 e MDREIS.OLB is not 
needed and may be del eted . On systems without an 
FPP , the file MDRFPP . OLB is not needed and may be 
deleted. The file may be deleted before starting 
the SYSGEN. 



o When the SYSGEN completes , perform the f ol 1 owi ng 
steps : 

>SET /UIC = [g ,m] 

>@PM0NBLD 

NOTE : The command file will pause if you desi re to 
edi t the build files for CLF , OVL , or MDR. Thi s 
will a 1 1 ow modifications to def aul ts for these 
programs . Instructions are included in the 
build f i 1 es . 

You can build the MDR, OVL, or CLF tasks 
separately from PMONBLD.CMD by invoking the 
command file MDRTKB.CMD. 

o You are now ready to run @SMPGEN to generate an MPB 
and run COL. This procedure is described in the next 
section. 



3.2 OPERATION 

3.2.1 Generating the Monitor Parameter Block (MPB) 

The MPB is the structure which contains the mea s u remen t 
pa rameters . 

To create a n MPB you invoke the command file SMPGEN.CMD. 

See Append i x G for an example SMPGE N . 
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The procedure is as follows: 
>SET /UIO[g,m] 
>(s>SMPGEN 

where [g,m] is your SPM-11M-PLUS kit di rectory. 

The MPB is created in the following way: SMPGEN creates a 
source file (default filespec is TRACE. PAR), assembles and 
builds the code in the file to produce a binary MPB file 
(default f i 1 espec is TRACE. MPB) . It is this file which is read 
by the data col lection task COL to initial ize the measurement 
parameters . 

In addition to the files menti oned above , SMPGEN al so will 
output, if requested , a saved answer file (default f i 1 espec is 
TRACE .CMD) . Thi s file can be input to another run of SMPGEN 
and will initialize the symbol table to the values of the 
variables saved in the file. 

SMPGEN is driven from a menu of parameter categories. To 
display the menu, type an <ESC> . The menu appears as: 



LEGAL PARAMETER CATEGORIES ARE : 

HOOK TASK MODE LABEL 

BUFFER DEVICE SYSTEM DONE 



The parameter categories can be specified in any order. If a 
parameter category is not specified, the parameters will 
receive default values from either: 

o The saved answer file, if one is speci f i ed . 
o The table of default parameters . 
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Table of Default Parameters 



HOOKS - all hooks enabled, excepting the LOAD 
OVERLAY , CALL DIRECTIVE PROCESSOR and USER 
INFORMATION hooks . 

BUFFERS - DYNAMIC region named TRC PAR created in 
partition GEN , 2 buffers with 8 blocks per 
buffer . 

TASKS - All tasks enabl ed for data collection. 
DEVICES - Al 1 devi ces enabled for data collection. 
MODE - MANUAL mode. 

SYSTEM - System Metrics enabled with 60 second 
sampl i ng i nterval . 



LABEL 



No label. 



To sel ect a parameter category, enter the name of the pa rameter 
category desired a s shown in the f ol 1 owi ng example : 

ENTER PARAMETER CATEGORY? HOOK 



Once a parameter category is sel ected , the detailed parameters 
are specified. Each parameter category has a menu of responses 
whi ch are poss i bl e for that parameter category . To get the 
menu , type <ESC> . When you are f i ni shed entering parameters , 
type "DONE" . 

A detailed description of each parameter category f ol 1 ows . 

o Label Field 

To select the 1 abel parameter catego ry , type : LABEL 

The following query will be d i spl ayed : 

ENTER MPB LABEL? 

The response may be any string from to 6 3 characters 
long. This user-definable string is stored in the MPB 
and wi 1 1 ty pi cal ly contain notes and comments appli- 
cable t o a particular mea s u remen t run. It is printed 
a s part of the heading on each page of the performance 
report . 
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Hooks 



To select the hooks parameter category, type : HOOK 

The hooks determine which resource usage events are 
recorded to the logfile. 

You do not select each hook individually. Rather, you 
select one or more groups of hooks. Each group of 
hooks contains the subset of hooks which will generate 
a consistent set of data for measuring the usage of a 
particular resource. Hooks may be chosen from the 
following g roups : 

- CPU USAGE HOOKS 

Thi s hook group measures task CPU usage. 

It is requi red for all metri cs for task CPU usage . 

- MEMORY USAGE HOOKS 

This hook group measures task memory usage. 

It is requi red for a 1 1 metri cs for task memory 
usage and % resident time. 

- I/O DEVICE USAGE HOOKS 

This hook group measures task usage of I/O devices 
and the file system . The file system is rega rded 
as any ACP whi ch manages a device. Exampl es are 
F11ACP and MTAACP. 

This hook group is requi red for all metrics 
relative to task usage of I/O devices or the file 
system. 

- LOAD OVERLAY HOOK 

This hook records the relative block number of a 
task's overl ay to the logfile. 

- CALL DIRECTIVE PROCESSOR HOOK 

Thi s hook record s the di recti ve I D of a directive 
to the logfile. 

- USER INFORMATION HOOK 

This hook is invoked when a task issues a directive 
of the form: GIN$ 7, PI ,P2 ,P3 ,P4 ,P5 ,P6 ,P7 ,P8. The 
eight parameters Pi - P8 are written to the 
logfile. 
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o Buffers 



To select the buffers parameter category , type : 
BUFFER. 



The hook buffers may be resi dent in either a static 
common or a dynami c region. The buffer type is 
s pec i f i ed by : 

ENTER BUFFER TYPE? 

The response may be either STATIC indicating a static 
common or DYNAMIC indicating a dynami c region . 

NOTE: If "STATIC" is selected , the COL task must have 
been, linked to a stati c common in the instal- 
lation phase ( see Chapter 3 , section 3.1.3). 

If "DYNAMIC " is selected , COL must not be 1 inked 
to the static common . 



If the buffer type is DYNAMIC , the name of the 
system-cont rol 1 ed partition in whi ch to create the 
dynami c region is s pec i f i ed by: 

ENTER NAME OF BUFFER MAIN (SYS) PARTITION? 

The name of the buffer common/ r eg i on is specified by : 

ENTER NAME OF BUFFER COMMON/REGION? 

The partition will be divided up into a number of hook 
buffers , determi ned by : 

ENTER NUMBER OF BUFFERS [2. :8. :2. ]? 
Note that from 2 to 8 buffers may be speci f i ed . 
Finally, the length of each buffer is specified by : 

ENTER BUFFER SIZE IN 512 B BLOCKS? 

A buffer can be from 1 to 1 6 bl ocks long; in other 
words , from 256 wo rd s to 4096 words long. 

I f a stati c common is used for buffering, the total 
space requ i red for buffers must fit into the common . 
I f a dynami c region is used , COL will create a region 
large enough to contain the buffers . 
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Tas k s 

SPM- 11M-PLUS can be set up to collect data for 
specific tasks. For example, there may be some tasks 
whose performance metri cs are not des i red at all. 
Typically, system "service" tasks , such as F11ACP, 
...MCR and QMG. . . fall into this category . 

To select the task parameter category , type : TASK. 

The f ol 1 owi ng query will appear : 

DO YOU WANT TO TRACE ALL TASKS? 

If your answer is N, you will be given two choices for 
selecting the tasks for data collection : 

Speci fy the tasks not to trace. 

Spec i fy the tasks to trace . 
The choice is made from the query : 

DO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? 
If the answer is Y , you are prompted with: 

ENTER NAME OF TASK NOT TO TRACE? 
I f the answer is N , you are prompted with : 

ENTER NAME OF TASK TO TRACE? 

You then type , one per line, the names of the tasks 
des i red or not des i red . Each taskname is from 1 to 6 
characters long. To termi nate the list of tasks , type 
<CR>. 

Up to 64 tasknames can be specified. 
Devi ces 

To get the devices parameter category , type : DEVICE. 



SPM- 1 1M-PLUS can be set up 
specific classes of devices, 
data on 1 y for selected cl asses 
the f ol 1 owi ng query : 



to col 1 ect data for 
I f you want to col 1 ect 
of devices , answer N to 
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DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? 

A device in R S X - 1 1M-PLUS may fall into one of four 
classes depending on the bit setting of the "Device 
Characteristics Word" U.CW1 in the UCB. 

- Directory Device (DV.DIR) 

- Sequential Device (DV.SQD) 

- Terminal Device (DV.TTY) 

- All Other Devices 

To enab.le data collection for a device class, answer Y 

to the query for that device class. The queries are: 

TRACE DISK (DIRECTORY DEVICE) I/O ACTIVITY? 

TRACE TAPE (SEQUENTIAL DEVICE) I/O ACTIVITY? 

TRACE TERMINAL I/O ACTIVITY? 

TRACE ALL OTHER DEVICES I/O ACTIVITY? 



Mode 

To select the mode parameter category , type: MODE. 

The performance monitor can be set up to collect data 
in three different modes. You select the mode by 
answeri ng : 

ENTER MODE? 

The possible modes are: MANUAL , AUTOSTOP and REPEAT, 
Each mode determines the manner in which a measurement 
interval begins and ends. A description of each mode- 
follows : 

Manual 

In manual mode, a measurement interval begins when 
the COL task is invoked and ends when the TRM 
(termination) task is run. 
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Autostop 

I n autostop mode , a measurement interval begins 
when the COL task is invoked and ends when either 
of the f ol 1 owi ng two events occur : 

A mark-time expires. 

A predetermined number of buffers have been 
filled. 

You determi ne the type of autostop by responding 
to : 

ENTER SAMPLING TYPE? 
with either TIME or BUFFER. 

I f TIME is speci f i ed , you then have to s pec i fy the 
timeout i nterval : 

ENTER SAMPLING INTERVAL TIME UNIT [D :MIN] 

ENTER SAMPLING INTERVAL IN units ? 

where "units" is the t i me unit speci f i ed in the 
previ ous query. Legal units are SEC , MI N or HR. 

NOTE : Do not confuse this sampling interval with 
the system metrics sampling interval 
descri bed in the next section. 



I f BUFFER is speci f i ed as the interval type , you 
must s pec i fy the number of buffers per sample: 

ENTER NUMBER OF BUFFERS PER SAMPLE? 

Note that each buffer is from 1 to 16 disk blocks 
(256 word s ) long. 

Repeat 

Repeat mode is autostop mode repeated a number of 
t i mes . The sampl i ng i nterval is specified a s for 
autostop mode. In addition, you must specify: 

The n umber of intervals 

The length of t i me be tween intervals. 
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You specify these parameters by answering the 
following queries: 

ENTER MAX. NUMBER OF SAMPLES? 

ENTER INTERVAL BETWEEN SAMPLES TIME UNIT [D :M I N] ? 

ENTER INTERVAL BETWEEN SAMPLES IN units ? 

where "units" is the time unit specified in the 
previous query. 

o System 

To sel ect the system-metrics parameter q roup , type 
"SYSTEM". , 

If you want the system metrics, answer Y the the next 
query : 

DO YOU WANT THE SYSTEM METRICS? [Y/Nj : 

If you answered Y , you must then specify the sampling 
i nterval by : 

ENTER SYSTEM METRICS SAMPLING INTERVAL (SEC ) ? 

o Done 

When you are finished enterlnci parameters, type 
"DONE". The SMPGEN procedure will then create: 

A monitor parameter block (MPB) file 
(filename. MPB) . 

A parameter source file ( f i 1 ename . PAR ) . 

A saved answer file (filename.CMD, if specified). 



Note: SMPGEN will prompt you for the parameter source 
file and saved answer file, and you must enter 
a valid file specification. 

3.2.2 Using COL 

The COL task is used to initialize the performance monitor, 
start data collection, collect data, stop data collection and 
clean up the performance monitor before exiting. 
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Instal ling COL 



The COL task can be installed in any partition. If possible, 
create a separate 3. 5K word partition for COL . If installed in 
a system-controlled partition, COL will automatically fix 
itself and mark itself as non-shufflable. It is therefore 
desi rabl e to install and run COL when there is little or no 
system activity in the partition in whi ch COL is installed so 
as to load COL in the lower end of the partition and reduce 
fragmentation of the partition. 

COL is taskbuilt with a default priority of 230. Note that COL 
has a higher pri ori ty than F11ACP and ...MCR, but a lower pri- 
ority than . . . LDR . It is highly recommended that the priority 
of COL not be altered to a value 1 ower than the def aul t value 
of 230 , otherwi se excessi ve overflows may occur which will 
invalidate the measurement runs. 

If full ASC 1 1 message text output is desired, install the 
COLMSG task . 

If you are using a static common for COL buffers , be sure to 
install it before installing the COL task . 

Install COL and COLMSG by : 

> I NS TRC PAR ;0NLY FOR STATIC COMMON 

> I NS COL 

> INS COLMSG 



Running COL 

To run COL , type a command line of the form : 
>C0L 1 ogf i 1 e/sw=MPBf i 1 e/sw 

The def aul t 1 ogf i 1 e speci f ication is S Y :[cur u i c] TR AC E . LOG. 
The def aul t MPBf i 1 e speci f i cation is SY :[cur ui c]TRAC E . MPB . 

Stoppi ng COL 

There are two ways to termi nate COL : 
o RUN TRM 

o Specify AUTOSTOP or REPEAT mode in SMPGEN. 



RUN TRM will terminate COL regardless of the mode in which COL 
is running: MANUAL, AUTOSTOP or REPEAT. 
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COL will also termi nate if any of the f o 1 1 owi ng abnormal 
conditions are detected : 

o Powerfail recovery 

COL will issue a SPRA$ di recti ve. Upon powe r f a i 1 
recovery , COL will simply exit. 

o Write errors 

If COL detects write errors , it wi 1 1 print a message 
and exit. Write errors will generally corrupt the 
logfile with invalid data. 

o Automatic 11 1/2 hour termination. 
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COL Switches 



Switch defaults 

Output : SY .'TRACE. LOG/DENS :800/EX : 100. / IF : 1 . / W I :10. 
Input : SY :TRAC E . MPB/B F :2 :8/DL :0/DV :LBO/PR :GEN 



Output Switches 


Descri pti on 


/AP 


Append records to end of magtape. COL wi 1 1 
space over all existing files on the magtape 
and append the records for this run starting 
at the current end-of-vol ume point. 


/DENS :densi ty 


Set tape density to 800 or 1600 bpi . 
Densi ties cannot be mi xed on a single tape 
vol ume . 


/EX : n 


Specifies disk file extent size in 256W 
blocks. 


/IF :n 


Speci f i es disk file initial size in 2 56W 
blocks. 


/WI :n 


Specifies number of retrieval pointers in 
wi ndow block. 


Input Swi tches 


/BF :m :n 


Number of buffers = m ; size of buffer = n 
256W blocks. This overrides the buf f eri ng 
description in the MPB . 


/DL :n 


Number of MINUTES COL delays before it 
starts data collection. 


/DV :ddnn 


Device selected for system metrics. 


/PR .-parnam 


Partition selected for system metrics. 


/TI :nn 


Collect data only for tasks with T I of TTnn. 
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Example 1 

>COL DB2 :[3 , 300]C PUTEST/ I F :1000/EX :2 00 = DB1 :[ 5 ,200]P ARM1/D V :DB2 : 

logfile is DB2 :[3 ,300]CPUTEST . LOG with initial size 1000 and 
extent si ze 200. 

MPB file is DB1 :[5 ,200]PARM1 . MPB with system metri cs speci f i ed 
for DB2. 



Example 2 

>C0L MM 1 :/DENS :1600 = DB1 : [ 5 , 2 00 ] S AMP L E . MPB 

logfile is on MM1 : in 1600 BPI ; MPB file is 
DB1 :[5 ,200]SAMPLE.MPB. 



Example 3 
>C0L = 

logfile is SY:[current u i c]TRAC E . LOG ; MPB file is SY:[current 
u i c ]TR AC E . MPB . 



NOTE : You cannot run COL with a null command line, i . e , >C0L 
<CR> . The COL task expects to see expl i c i t f i 1 especs or a 
bare "=" indicating defaults on both input and output. More- 
over, you cannot invoke COL with a command of the form: 

>RUN COL 

since no f i 1 especs can be specified with this form . One final 
thought in this regard: only one copy of COL can be active in 
the system at a time. If multiple invocations of COL are 
attempted at different terminals, all but the first will be 
rejected with an error message "MONITORING ACTIVITY IN 
PROGRESS" . 

Once COL is activated, it will run in the mode specified in the 
MPB but always for a maximum of 11 1/2 hours. This time limit 
is imposed because the KW11-P clock time will overflow in a 
little over 11 1/2 hours . 
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COL Messages 



COL outputs two types of messages : error messages and status 
messages . 

Full ASC 1 1 error message text will be printed only if the 
COLMSG task is installed. If the COLMSG task is not installed, 
COL will print a message of the form "COL ERROR XXXXXX" , where 
XXXXXX is the error number. The error messages are listed by 
error number in the following list. Error messages are i ssued 
if an error condi ti on occurs while COL is starti ng up and 
initializing the performance monitor. Error messages are 
output to the termi nal of issue (TI :) for COL . 

Status messages are issued after COL has run its initialization 
phase. There are status messages for both norma 1 and error 
conditions. Status messages are issued to the console termi nal 
(CO :) . The COLMSG task does not have to be i nstal 1 ed to get 
the status messages ; as they a re printed d i rectly by the COL 
task . 



COL Error Messages 

000000 COLMSG -- XXXXXX (DSW) GET COMMAND LINE ERROR 

Expl anati on : A " Get MCR Command Line" directive failure 
occurred. 

User Act i on : Reenter COL command line using correct 
form . 



NOTE : 1 1 1 egal command forms are : 

1. >C0L <CR> 

2. >RUN $C0L <CR> 



Legal command line forms are : 

1 . >C0L filespec/sw = f i 1 espec/sw 

2. >C0L filespec/sw = /sw 
3 . >C0L =f i 1 espec/sw 

4. >C0L = 
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000001 COLMSG -- COMMAND SYNTAX ERROR 

Explanation: Entered i ncorrect syntax for command line. 
User Act i on : Reenter command line with correct syntax . 

000002 COLMSG -- MPB FILENAME SYNTAX ERROR 

Explanation: Entered i ncorrect syntax for MPB filename. 
User Acti on : Reenter MPB filename using correct syntax. 

000003 COLMSG -- XXXXXX (FCS) MPB FILE ACCESS FAILURE 

Explanation : COL failed to open MPB file or received a 
read error when attempt i n g to read the MPB file. The 
code XXXXXX (FCS) indicates the FCS error code returned 
to COL . 

User Acti on : Check that specified MPB file exists, the 
vol ume is mounted (if disk) , or that the file protecti on 
does not prevent COL from reading the MPB. 

000004 COLMSG -- XXXXXX (DSW) ASSIGN LUN FAILURE 

Expl anati on : COL failed to assign a LUN to the logfile 
device. 

User Act i on : Check that the device speci f i ed for 

1 ogf i 1 e is in the system configuration. 

000005 COLMSG -- ILLEGAL LOGFILE DEVICE TYPE 

Explanation : The device speci f i ed for the logfile is 
not of the correct type . Valid logfile device types 
are: Di rectory structured (disk, DECTAPE ) , or Sequenti al 
(magtape) . 

User Acti on : Specify a device which is ei ther di rectory 
structured or sequential . 

000006 COLMSG -- LOG F ILENAME SYNTAX ERROR 

Explanation : Entered i ncorrect syntax for logfile. 

User Action : Reenter logfile specification using 
correct syntax. 

000007 COLMSG -- XXXXXX (FCS) LOGFILE ACCESS FAILURE 

Explanation : COL failed to open the logfile. The code 
XXXXXX (FCS) is the FCS error returned to COL. 
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User Acti on : Check that the logfile volume is mounted 
native and the necessary di rectory exists (if disk) , or 
the volume is mounted foreign and on 1 i ne (if magtape) . 

000010 CQLMSG -- ILLEGAL BUFFER SPECIFIED 

Explanation: The parameters specified by the / B F :n :m 
switch were not valid. Either the number of buffers (n) 
was out of range (<2 or >8) or the buffer size was out 
of range ( >16) . 

User Acti on : Respeci fy a valid buffer count or size via 
the /B F swi tch . 

000011 COLMSG -- XXXXXX (DSW) BUFFER PARTITION NOT IN SYSTEM 

Explanation : The partition spec i f i ed in the MPB is not 
in the system . 

User Acti on : If the buffer partition is a static 
common, check that the static common partition exists 
and that the common is i nstal 1 ed. 

000012 COLMSG BUFFERS WILL NOT FIT INTO PARTITION 

Explanation : The number of buffer blocks speci f ied in 
the MPB (NUMBER OF BUFFERS * BUFFER SIZE IN 512 B 
B LOCKS ) is greater than the number of 512 B blocks in 
the physical buffer partition. 

User Acti on : Do a SMPGEN and speci fy the NUMBER OF 
BUFFERS and BUFFER SIZE IN 512 B BLOCKS such that the 
product o f the two is 1 ess than the number of 512 B 
blocks in the physical buffer partition. 

000013 COLMSG XXXXXX (DSW) CANNOT CREATE BUFFER PARTITION OR 
ADDRESS WINDOW 

Explanation : COL recei ved a DSW error when attempt i ng 
to create the dynamic buffer partition specified in the 
MPB , or when attempti ng to create an address wi ndow to 
map the dynami c parti ti on . The error XXXXXX (DSW) is 
the DSW error from the Create Region directive or from 
the Create Address Window directive. 

User Action: Check that enough space exists in the 
partition to contain a dynami c region with the size 
specif ied in the MPB. 
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000014 COLMSG -- MONITORING ACTIVITY IN PROGRESS 



Explanation : A multiple invocation of the COL task was 
attempted . Only one copy of COL can be active at a 
time. 

User Act i on : Do not attempt to run more than one copy 
o f C L at a time. 

000015 COLMSG -- INVALID MPB FILE 

Expl anati on : The MPB filespec specified in the COL 
command line is not the name of a valid MPB file. 

User Action: Reenter a f i 1 es pec for a valid MPB file. 

000016 COLMSG -- INFORMATION RECORD ALLOCATION FAILURE 

Explanation : Insuf f i ci ent space exists in the buffer 
partition to contain all the Inf ormat i on Records. 

User Acti on : Do a SMPGEN and speci fy enough blocks 
(NUMBER OF BUFFERS * BUFFER SIZE I N 512 B BLOCKS) to 
contain all the Inf ormati on Records . The space requ i red 
is roughly that needed to contain the largest of the 
foil owi ng three system lists: l)TCBs , 2) PCBs , 3) 
DCB-UCBs . 

000017 COLMSG KW11-P VECTOR OR CSR UNAVAILABLE 

Explanation : Either the KW11-P vector is in use , or the 
KW11-P CSR is non-existent on the UNIBUS . 

User Acti on : Check that the correct KW11-P vector and 
CSR were speci f i ed in the procedure @ PMONBLD.CMD , that 
the vector is not used by another RSX-1 1M-PLUS driver or 
task, and that the CSR is addressable on the UNIBUS. 

000020 COLMSG -- CANNOT USE SYSTEM' S KW11-P AS SPM-1 1M-PLUS 
CLOCK 

Expl anati on : The RSX-1 1M-PLUS system clock is a KW11-P 
and a n attempt was made to use it a s the SPM-1 1M-PLUS 
(performance monitor) clock. 

User Acti on : Check that a separate KW11-P was i nstal led 
for use by the SPM- 1 1M-PLUS software , and that the 
vector and CSR specified in the procedure @PMONBLD.CMD 
was for this clock. 
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000021 COLMSG -- POOL NODE ALLOCATION FAILURE 

Explanation : COL could not allocate a RSX- 1 1M-PLUS pool 
node. 

User Acti on : Re-run COL when sufficient pool is 
available. 

000022 COLMSG -- BUFFER OVERFLOW 

Explanation : COL failed to a 1 1 ocate space for a hook 
record because all buffers were full. 

User Acti on : Re-run COL , using a 1 arger buffer size 
specified either vi a SMPGEN.CMD or the /BF switch. 

000023 COLMSG PARTITION SPECIFIED NOT IN SYSTEM 

Expl anati on : The partition specified via the /PR switch 
is not con f i gu red in the system. 

User Action: Respecify a partition configured in the 
system . 

000024 COLMSG -- ILLEGAL DELAY VALUE SPECIFIED 

Expl anation : An illegal del ay value has been speci f i ed 
via the /DL switch. 

User Acti on : Re-speci fy a del ay value in the correct 
range (0 to 28800) . 



COL Status Messages 

COL -- PERFORMANCE MONITOR INITIALIZED 

Expl anation : COL has successful 1 y i n i t i a 1 i zed and is 
now ready to coll ect data. 

User Acti on : None 

COL -- PERFORMANCE MONITOR EXITING 

Explanation: COL has stopped data collection and has 
cleaned up its databases. This status message is issued 
by COL immediately prior to exiting. 

User Acti on : None 
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COL -- CANNOT MAP OUTPUT BUFFER 

Explanation : COL received an error when attempting to 
map to the output buffer using the Map directive. 

User Act i on : Check that the dynamic region used as the 
output buffer was successfully created. 

COL -- LOGFILE WRITE ERROR 

Explanation : COL received an FCS or Q 1 error when 
attempt i n g to write to the 1 o g f i 1 e . 

User Acti on : Check the i ntegri ty of the logfile. I f 
repeated errors occur to the same logfile, rerun COL to 
create a new disk file or mount a fresh tape. Ensure 
the logfile vol ume is mounted via the MOU command . 

COL -- LOGF ILE CLOSE ERROR 

Explanation: COL recei ved an error when a ttempt i ng to 
close the logfile. COL will exit shortly after printing 
this message with the logfile improperly closed. 

User Acti on : Because the logfile was i mproperly closed, 
it may be difficult to read the logfile and produce a 
performance report. 

COL -- BUFFER OVERFLOW 

Expl anati on : Hook records were written to the hook 
buffer faster than COL could write them to the logfile. 

User Act i on : I n general , the data coll ected during a 
mea s u remen t i nterval which overf 1 owed is not usable by 
the MDR task to produce a performance report. An 
attempt should be made to rerun the measurement to 
obtain data without overf 1 ow. Prior to attempting 
another mea s u remen t run , a SMPGEN should be run with 
1 arger buffers specified than for the measurement run 
which overflowed. 



3.2.3 Using TRM 

The TRM task is used to manually signal the COL task to stop 
data col 1 ecti on , cleanup and exit. TRM will cause COL to exit, 
regardl ess of the mode in which COL was running : manual , 
autostop o r repeat . 

TRM is run by the command >RUN TRM. 
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3.2.4 Using MDR 



MDR is used to read the logfile and produce a performance 
report. MDR is used in conjunction with DRS (sorting) task to 
produce the performance report. The general procedure is as 
f o 1 1 ows : 

o > INS DRS 
>RUN MDR 

MDR>LISTFILE/sw=LOGFILE/sw 

MDR will read the command line and execute pass 1. MDR 
will then attempt to spawn the task DRS. If MDR 
detects an error in the spawn , or MDR has been built 
to prevent automatic spawn , the DRS pass must be 
executed manually. In this case , MDR will print the 
following message and suspend : 

MDR -- YOU MUST NOW SORT THE INTERMEDIATE FILE BY 
USING DRS.TSK 

MDR -- 

>DRS RESOURCE.SRT = RESOURCE.TMP/FO :V : 1 5 6 / K E :1 . 12/PR :T 

MDR -- AFTER THE SORT HAS COMPLETED , RESUME THIS TASK 
( ... MDR ) 



NOTE: Rather than type the command 1 i ne to DRS as shown 
above, you can simply invoke the command file @DRS . 



o >@ D R S sorts the intermediate file, 
o >RES 

MDR executes pass 2 and prints the performance report . 
o MDR> Z 

Certain MDR command switches restrict the input data which will 
be processed . If a logfile contains too much acti vi ty for MDR 
to reduce the data without running out of space, these switches 
(/AF, / B F , /-MD , /NT , /NU , /TS , /UC) may be used to reduce a 
logfile by successive runs of MDR , analyzing only parts of the 
workload in each run. 

When using the switches /NT, /NU, /TS, or /UC , MDR will prompt 
for the task or device names after the command line is 
processed. The tasknames are specified as 1 to 6 RAD50 
characters per entry. Only generic tasknames are used for /NT 
or /TS. The TI device names are entered as "DDnn :" , with one 
entry per line. 
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MDR Switches 



Switch defaults 
output : SY .-REDUCE. RPT/SP 



input : SY :TRAC E . LOG/DM :2/L I :2/RW/SI :613/MD/SK :0/DE :800/- IC/-SC 



Output Switches 


Description 


/SP /-SP 


SPool output file 


Input Switches 


/AF :PChi g h : P C 1 ow 


On 1 y process records from AFter specified 
time 


/BF :PChi gh : PC 1 ow 


Only process records from BeFo re s pec i f i ed 
time 


/DE :nnnn 


Select input magtape DEnsity, 800 or 1600 
( i gnored unless /RW is also used ) 


/DM :nn 


DuMp specified record types , n n is total of 
des i red types : 

1 - buffer headers 

02 - unknown record types 

04 - system configuration info records 
1 - task event hook records 
20 - system metric records 

40 - user i nformati on hook records (HSUSER} 
100 - load overl ay hook records (H$0VLY) 
200 - call d i recti ve processor hook records 
(H$CDRP) 


/IC 7-IC 


Repl ace the % resource column of the report 
with a count of incomplete intervals. 


/LI :nn 


Deta i 1 level of task workload metrics : 

00 - n o report produced 

1 - system-wi de summary only 

02 - system and task summari es 

3 - system , task, and T I : summaries 

04 - a 1 1 summari es and each complete 

task run 

05 - a 1 1 summaries and all task invocations 




(continued on next page) 
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MP R Switches (continued) 



Input 


Switches 


Description 


/MD 


/ 


-MD 


Report on tasks with missing data 


/NT * 






Do Not process hooks for listed Tasks 


/NU * 






Do Not process hooks for listed devices a s 
TI : 


/SC 


/ 


-SC 


Produce System Configuration section of 
report 


/ S I :nn 






Sel ects the contents of Sampling Interval 
report by setting nn to the total for the 
desi red i terns : 

000 - no report produced 

001 - data collection start/stop times 

002 - % CPU usage 

004 - % memory partition usage 

010 - % device time busy 

020 - % device space used 

040 - % POOL used 

100 - % CKPT space used 

200 - clock time of metrics 

400 - trailing blank line after the metri cs 


/SK :nnn 




SKip nnn files when open i n g tape input file 


/RW 


/ 


-RW 


ReWind tape input file before opening 


/TS * 






Process hook records only for listed TaSks 


/UC * 






Process hook records only for listed 
devices as T I : 




* 


- the 

- the 


switches /NT and /TS are mutual ly exclusive, 
switches /NU and /UC are mutual ly exclusive. 
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MDR Messages 



The MDR messages are i ssued to the T I device under which MDR 
runs . This section discusses the messages which MDR can issue. 

MDR -- PLEASE ENTER TASKNAMES ONE AT A TIME FOLLOWING EACH 

MDR -- WITH A <CR>. TYPE JUST A <CR> AFTER THE LAST ONE IS 

ENTERED 
MDR -- TSKNAM> 

Explanation: This is the prompt for the generic task- 
names for filtering by the /NT or /TS switch. The last 
line of this message is repeated for each line of input. 

User Act i on : Enter generi c task name(s). 



MDR -- PLEASE ENTER TI DEVICES (DDNN :) ONE AT A TIME FOLLOWING 
EACH 

MDR -- WITH A <CR>. TYPE JUST A <CR> AFTER THE LAST ONE IS 

ENTERED 
MDR -- TI DEVICE) 

Explanation : This is the prompt for device names to be 
used by the /UC or /NU filter. The last line of this 
message is repeated for each line of input. 

User Action: Enter full device name(s) as "DDnn :" . 



MDR -- YOU MUST NOW SORT THE INTERMEDIATE FILE BY USING DRS.TSK 
MDR -- (E.G.) MCR>DRS 

RESOURCE. SRT=RESOURCE.TMP/FO :V :156/KE :1 . 12/PR :T 
MDR -- AFTER THE SORT HAS COMPLETED , RESUME THIS TASK (TSKNAM) 

Expl anati on : This message indicates that the first pass 
o f MDR has compl eted . Manua 1 intervention is now 
requ i red to run the DRS task with the given command . 
The task name under which MDR is running is given in 
parenthesis in the last line of the message. 

User Act i on : Run the DRS task ( @ D R S . C M D ) , and when it 
has compl eted , resume the MDR task. 



MDR -- DSW :###### F. ERR :###### IOSB :###### ###### PC :###### 
SP 

MDR -- STK :###### ###### 

Explanation : This is a status message which gives 
detail of the internal state of MDR at the t i me when an 
error is detected. This message is always followed by 
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one of the messages discussed below, which describes the 
actual error condition. 

User Act i on : See action specified for the message 
issued immediately following this status message . 



MDR -- AN INCOMPLETE RESOURCE UTILIZATION REPORT WILL BE 
PRODUCED 

Explanation : An error occurred which prevented the 
compl eti on of pass 1 1 of MDR. Al though a report wi 1 1 be 
produced , not a 1 1 task-workl oad data has been summa- 
r i zed . A previous error message is i ssued giving the 
cause o f this condition. 

User Act i on : As specified for previous message . 

{ 

MDR -- ATTEMPT TO PRINT NULL TWB 

Expl anati on : An internal inconsistency occurred in the 
pass 1 1 processi ng of MDR. 

User Acti on : * * * SPR ! 

MDR -- ATTEMPTING TO DEALLOCATE TWB NOT IN TSKHD 

I 

Explanation : An i nternal i neons istency occurred in the 
pass I processi ng of MDR . 

User Action : * * * SPR ! 



MDR -- CHECKPOINT USAGE > 100% 

Explanation: A Checkpo i nt metric indicates more than 
100% usage of the checkpoi nt space. The metric is not 
reported . 

User Acti on : Ensure 1 ogf i 1 e is not corrupted. 



MDR -- CLOCK STOPPED OR HOOK RECORD OUT OF TIME SEQUENCE . 

Expl anati on : The records in the 1 ogf i 1 e do not f ol 1 ow a 
strict time sequence . Thi s condi ti on i nval i dates the 
data in the 1 ogf i 1 e . 

User Action : Ensure that the KW 1 1 - P clock is 
functioning. Re-collect the data . 

i 
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MDR -- COMMAND READ ERROR 

Explanation : An I/O error occurred while attempti ng to 

read the MDR command line. 

User Act i on : Reenter the MDR command . 



MDR -- COMMAND SYNTAX ERROR 

Expl anati on : The command a s entered has improper 
syntax . 

User Act i on : Reenter the corrected MDR command . 

MDR -- COMPLETION ERROR IN INPUT READ 

Expl anati on : An I/O error occurred while reading the 
1 ogf i 1 e . Thi s condi ti on will be treated a s end-of-f i 1 e 
and MDR will attempt to continue. This may be 
symptomat i c of a corrupted logfile. 

User Acti on : Check 1 SB for error cause. Re run MDR 
using another logfile if necessary . 



MDR -- CONFLICTING SWITCHES /TS+/NT OR /UC+/NU 

Explanation : The switches /IS and /NT were both speci- 
fied, or the swi tches /UC and /NU were both speci f i ed. 
Only one of each pa i r of switches may e speci f i ed . 

User Act i on : Reenter the command line without both of 
the conf 1 i cti ng switches. 



MDR -- DEVICE USAGE > 100% 

Expl anati on : MDR processed a system metr i c record which 
indicates greate r than 100 percent of device uti 1 i - 
zat i on . No graphic output will be produced for the 
suspect record. 

User Acti on : * * * SPR I 



MDR -- DEVICE ' S AC P NOT FOUND 

Expl anati on : The system i nf ormati on records i ndi cated 
that a devi ce was mounted , yet no TCB for the AC P task 

( 
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was found . The device may have been dismounted concur- 
rently with COL 1 s scan of the system conf i gurati on . A 
generic AC P name will be used for the device' s AC P 
functions. 

User Act i on : None . 



MDR -- DYNAMIC SPACE ALLOCATION FAILURE 

Explanation: MDR was unable to suf f i ci ently extend 
itself to provide space for initialization of pass I . 
This indicates a severe shortage of necessary dynamic 
space. 

User Acti on : Ensure MDR is checkpoi ntabl e . Ensure the 
partition where MDR runs has enough space for MDR to 
extend . Use SET /MAXEXT to al 1 ow sufficient extension. 
Use of smal 1 er buffers by COL wi 1 1 1 ower the MDR space 
requ i rement . 



MDR -- ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 

Explanation : An I/O error occurred when attempt i ng to 
open the 1 ogf i 1 e on magtape . The drive may have been 
mounted to MTAAC P which is incorrect since MDR does QIOs 
di recti y to the tape device driver. Ensure the magtape 
is mounted f orei gn . 

User Act i on : Correct the condition and rerun MDR . 



MDR -- ERROR CLOSING INPUT FILE 

Explanation: An I/O error occurred when closing the 
input logfile. 

User Act i on : None . 



MDR -- ERROR CLOSING REPORT FILE 

Explanation : An I/O error occurred when closing the 
report file. Thi s file will not be properly closed or 
spooled, or MDR attempted to spool the output file but 
the task PRT . . . was not installed. 

User Acti on : Correct the condition and manual ly close 
the file, or rerun MDR . 
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MDR -- ERROR CLOSING RESOURCE. TMP FILE 

Explanation: An I/O error occurred a t the end of pass I 

when closing the RESOURCE. TMP file. The DRS task wi 1 1 

not be able to read this file until it is properly 
closed. 

User Action : Correct the condition and manually close 

the file, or rerun MDR. 



MDR -- ERROR DELETING RESOURCE . TMP FILE 

Explanation : An I / error occurred when MDR deleted 
its temporary file. The file is not properly closed, or 
deleted. 

User Act i on : Manually unlock and delete this file. 



MDR -- ERROR IN GTSK$S 

Explanation : The directive failed preventing MDR from 
obtaining its taskname . The message requesti ng the sort 
to be run wi 1 1 not include MDR's taskname. 

User Act i on : None. 



MDR -- ERROR IN INPUT READ QIO 

Explanation : An I/O error occurred while reading the 
logfile. This condition wi 1 1 be treated a s end-of-file 
and MDR will attempt to conti nue . This may be 
symptomat i c of a corrupted logfile. 

User Action : Check DSW for error cause. Rerun MDR 
using another logfile if necessary . 



MDR -- ERROR OPENING RESOURCE. SRT FILE 

Explanation : An error was reported by FCS when MDR 
attempted to open the RESOURCE. SRT file for pass 1 1 . 
Pass 1 1 will not be able to run . 

User Act i on : Correct the condi ti on indicated by F . ERR 
and rerun MDR. 
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MDR -- ERROR OPENING RESOURCE. TMP FILE 

Expl anat i on : An error was reported by FCS when MDR 
attempted to open the RESOURCE. TMP file for write in 
pass I . Pass I will not be able to run . 

User Act i on : Correct the condition i ndi cated by F . ERR 
and rerun MDR . 



MDR -- ERROR OUTPUTTING PRINT LINE 

Explanation : An error was reported by FCS when MDR 
attempted to output a record to the report file. MDR 
wi 1 1 attempt to continue to produce the report . I f this 
error is not caused by a transient condi ti on the message 
wi 1 1 be repeated , and MDR will have to be aborted . 

User Act i on : Correct the condition and rerun MDR . 



MDR ERROR READING MPB 

Explanation : An I/O error occurred when attempt i ng to 
read the first block of the 1 o g f i 1 e . 

User Acti on : Correct the condi ti on and rerun MDR . 

( 

MDR -- ERROR READING RESOURCE. SRT FILE 

Explanation : An I/O error occurred in pass 1 1 when 
attempti ng to read from the RESOURC E . SRT file. This 
will be treated a s an end-of -f i 1 e condition. 

User Act i on : Correct the condi ti on and rerun MDR . 

( 

MDR -- ERROR REOPENING RESOURCE. TMP FILE 

Explanation : An I/O error occurred when attempti ng to 
re-open the RESOURCE .TMP file so it could be del eted. 
The RESOURCE. TMP f i 1 e wi 1 1 not be del eted. 

User Acti on : Delete the file manual ly . 



MDR -- ERROR SKIPPING OVER MPB BUFFER 

Explanation : An I/O error occurred when repositioning 
the tape 1 ogf i 1 e so the MPB could be reread once the 
buffer size is known . 

( 
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User Acti on : Correct the condi ti on and rerun MDR. 

( 

MDR -- ERROR WRITING RESOURCE. TMP FILE 

Explanation : An I/O error was reported by FCS for a 
write operation during pass I . 

User Acti on : Correct the condition and rerun MDR. 

MDR -- EXPECTED RIB NOT FOUND 

Explanation : An inconsistency occu rred in MDR's 
interna] dynamic data structures. 

User Acti on : See Chapter 7 , Sect i on 7.3. 

( 

MDR -- EXPECTED RWB PREDECESSOR NOT FOUND IN OVERLAP 

Expl anati on : An i nconsi stency occurred in MDR's 
internal dynami c data structures . 

User Acti on : * * * SPR ! 

MDR -- EXPECTED RWB PREDECESSOR NOT FOUND IN MERGE 

Explanation : An i nconsi stency occu rred in MDR's 
internal dynamic data structures . 

User Acti on : * * * SPR ! 

MDR -- IDLE TIME > 100% 

Explanation : MDR processed a system metric record which 
i ndi cates greater than 100 percent of CPU idle time. No 
graphic output wi 1 1 be produced for the suspect record. 

User Acti on : See Chapter 7 , Secti on 7.5. 
MDR IMPROPER FORMAT OR NO SUCH DEVICE IN SYSTEM. PLEASE 

rv r t \/ n r 

K L I I Y t . 

Explanation : An improper response was entered to the 
prompt for T I filter devices. 

User Act i on : Enter a corrected response. 
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MDR -- INPUT F ILESPEC OR SWITCH SYNTAX ERROR 

Explanation : An improper command line was used with 
MDR. 

User Act i on : Reenter the command. 



MDR -- INVALID DENSITY SELECTED , 800 OR 1600 ONLY 

Expl anati on : A magtape densi ty other than 800 or 1600 
was specified. 

User Acti on : Reenter the command with the correct 
dens i ty . 



MDR -- INVALID DEVICE SPACE METRIC RECORDED 

Explanation : A system metri c record indicates more than 
100% of device space used . The device space metric will 
not be reported . This metric is only avai 1 abl e for 
dev i ces mounted to F11ACP. 

User Acti on : Ensure 1 ogf i 1 e not corrupted . 



MDR INVALID INPUT DEVICE TYPE 

Expl anati on : An attempt was made to reduce a 1 ogf i 1 e 
whi ch is not on either a disk or tape volume. MDR can 
only use disk or tape for the input file. 

User Acti on : Do not use MDR to read 1 ogf i 1 es not 
residing on disk or tape . 



MDR -- INVALID INPUT FILESPEC 

Explanation : A syntax error occurred in the input 
filespec part of the MDR command. 

User Act i on : Correct and reenter the command . 



MDR -- INVALID LISTING LEVEL 

Expl anati on : An invalid listing level was spec i f i ed in 
the /LI swi tch . Acceptabl e values range from to 5. 

User Act i on : Correct and reenter the command . 

{ 



12/81 



GUIDE TO USING SPM-11M-PLUS 



3-34 



MDR -- INVALID MPB FOUND BY ALC 

Explanation : The logfile was found to contain improper 
data . Thi s may be a result of using MDR to read a 
logfile produced by an i ncompatabl e COL version. This 
may also be the resul t of using MDR to read a file which 
was not produced by COL, or was corrupted . 

User Act i on : Rerun MDR using a valid logfile. 



MDR -- INVALID MPB FOUND BY INF 

Explanation : The MPB did not pass validity testi ng when 
it was reread once the logfile buffer size was known . 
The logfile may have been corrupted while MDR was 
processi ng it. 

User Acti on : * * * SPR ! 



MDR -- INVALID POOL METRIC RECORDED 

Explanation : A Pool metric i ndi cates more than 100% DSR 
usage . The metri c is not reported . 

User Act i on : Ensure logfile is not corrupted. Do not 
change DSR size while COL is runni ng. 



MDR -- INVALID RAD50 CHARACTER IN YOUR INPUT. PLEASE RETYPE. 

Explanation : The response to the taskname prompt for 
f i 1 tered names was not a valid RSX-1 1M-PLUS taskname. 
Al 1 1 etters should be in uppercase . 

User Acti on : Correct and retype the response. 



MDR -- INVALID TIME VALUES ; /AF MUST BE EARLIER THAN /BF 

Expl anati on : An attempt to use time filter values which 
overl apped causes this message . This condition will not 
allow any records to pass the filter for processing. 

User Acti on : Correct and reenter the MDR command . 
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MDR -- MEMORY USAGE > 100% 

Explanation : MDR processed a system metric record which 
i ndi cates greater than 100 percent of partition utili- 
zation. No graphic output will be produced for the 
suspect record. 

User Acti on : * * * SPR ! 



MDR -- MISSING INFO FOR DEVICE METRIC 

Explanation : The Info record descri bi ng the system 
metri c device was not found . Device system metrics will 
not be reported . 

User Acti on : Do not load or unload device drivers while 
COL is active. Ensure 1 ogf i 1 e is not corrupted . 



MDR -- MISSING I $S YS FOR POOL METRICS 

Explanation : The DSR size was not found in the logfile. 
The Pool system metric is suppressed . 

User Act i on : Ensure logfile is not corrupted . 



MDR -- MISSING " = " AND INPUT F ILESPEC 

Explanation : The input command contai ns no " = " and no 
input f i 1 espec . Both input and output f i 1 e s p e c s must be 
suppl i ed or def aul ted . 

User Ac t i on : Enter a corrected MDR command including 
the "=". 

MDR -- MORE THAN ONE INPUT FILESPEC NOT ALLOWED 

Explanation : The MDR command contains more than one 
input f i 1 espec . 

User Acti on : Enter a corrected MDR command with only 
one input filespec. 



MDR MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 

Expl anati on : The MDR command contains more than one 
output f i 1 espec . 

( 
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User Act i on : Enter a corrected MDR command with only 
one output filespec. 



MDR -- MPB FOUND AT LOCATION OTHER THAN FIRST RECORD OF FILE 

Explanation : An MPB was read in the wrong position in 
the 1 o g f i 1 e . This is indicative of a corrupted logfile. 
MDR will bypass this MPB and attempt to continue to 
process the corrupted logfile. Reports produced from 
this logfile are suspect . 

User Action : Use a di f f erent logfile for analysis. 

MDR -- MPB NOT FOUND - NOT TRACE FILE 

Explanation : The MDR input file did not begin with a 

MPB . Either the file was corrupted or it is not a 
logfile. 

User Acti on : Use a di ff erent logfile for analysis. 

MDR -- NO FOLLOWING PRIMARY RWB FOUND 

Explanation : An internal i neons istency was detected in 
pass I . 

User Action : * * * SPR ! 



MDR -- NO FPP OR BUILT /-FP 

Expl anati on : MDR is unable to initialize for FPP ASTs . 
Either MDR was taskbuilt with the /-FP switch , or the 
processor where MDR is runn i ng has no FPP. This message 
cannot occur if the E I S version of MDR is used . 

User Acti on : Rebuild MDR using the di stri buted . C MD 
file. Only run the FPP versi on of MDR on processors 
with an FP-11. 



MDR -- OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation : A syntax error was detected in the output 
f i 1 espec or an invalid output switch was speci f i ed. 

User Acti on : Correct and reenter the MDR command. 
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MDR OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The logfile indicates buffer overflow 
occurred before the MPB was written . Either the logfile 
was corrupted , or the file was not produced by COL . 

User Action : Use another file for MDR input . 



MDR -- OVERFLOW IN FIRST PASS SUMMARIZATION 

Expl anati on : A f 1 oati ng overflow occurred in pass I . 
Incorrect data wi 1 1 be reported for the particular task 
and summaries which this data represents . 

User Acti on ; Use the resulting report with caution. 
Use filtering to limit the amount of data processed to 
prevent this condition. 



MDR -- OVERFLOW IN SECOND PASS SUMMARIZATION 

Expl anati on : A floating overf 1 ow occurred in pass 1 1 . 
Incorrect data wi 1 1 be reported for the particular task 
and summari es which this data represents. 

User Acti on : Use the resulting report with cauti on . 
Use filtering to limit the amount of data processed to 
prevent this condition. 



MDR -- PARTITION RIB NOT FOUND FOR S$MEM 

Explanation : A system metri c record was read for a 
partition which was not described by the system con- 
f i gurati on i nformation records . The graphi c output of 
memory utilization will be suppressed . 

User Acti on : None . 



MDR -- PRINT LINE TOO LONG 

Expl anati on : MDR generated a report file record longer 
than 132 bytes . The line is truncated by the logic 
which writes to the file. 

User Acti on : * * * SPR ! 



- 
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MDR -- RIB LIST LINKAGE ERROR 

Explanation: An i nconsi stency was detected in MDR 1 s 
internal representati on of the system configuration. 

User Acti on : * * * SPR ! 



MDR -- RWB WITHOUT TWB FOUND IN RESOURCE. TMP 

Explanation : A record in the RESOURCE . SRT file was 
encountered in an illogical position. The record is 
disgarded. 

User Acti on : * * * SPR ! 



MDR SUMMARIZING FROM NULL TWB 

Explanation : An i nconsi stency was detected in the pass 
1 1 data structures. 

User Act i on : * * * SPR ! 



MDR -- SUMMARIZING INTO NULL TWB 

Explanation : An inconsi stency was detected in the pass 
II data structures. 

User Action : * * * SPR ! 



MDR -- SVTK FAILURE 

Explanation : The RSX execut i ve rejected MDR 1 s attempt 
to s pec i f y an SST vector. 

User Act i on : Correct the condition indicated by the DSW 
and rerun MDR. 



MDR -- SYSTEM + IDLE TIME > 100% 

Expl anati on : A system metric record was read which 
i ndi cates the total of kernel and idle t i me is greater 
than the elapsed time. The graphic output for the 
record is suppressed . 

User Act i on : See Chapter 7, Sect i on 7.5. 
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MDR -- SYSTEM TIME > 100% 

Explanation: A system metri c record was read which 
indicates more kernel t i me than elapsed time. The 
graphic output for the record is suppressed. 

User Act i on : See Chapter 7, Section 7.5. 



MDR -- TI : READ ERROR 

Explanation : An I/O error occurred when reading filter 
values from the user. The read with prompt whi ch is 
used to obtain these inputs is not valid from a VT : 
(e.g. BATCH) 

User Act i on : Rerun MDR . 



MDR -- TRAP ### 

Explanation : A floating point or con vers i on error 
occurred . The octal n umber in this message indicates 
the preci se error cause. 

User Acti on : * * * SPR ! 



MDR -- TRUNCATED INPUT FILE RECORD 

Explanation : The end of a buffer was reached before a 1 1 

the records in that buffer were processed. This 
indicates a corrupted 1 ogf i 1 e . 

User Act i on : Use a different 1 ogf i 1 e for analysis. 



MDR -- TWB/RWB/R IB DYNAMIC SPACE ALLOCATION FAILURE 

Expl anat i on : MDR was unable to get needed virtual space 
for a dynami c structure in pass I . However suf f i cent 
dynami c storage was obtained to begin pass I . 

User Act i on : Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend . Use SET /MAXEXT to al 1 ow sufficient extension. 
Use of smal 1 er buffers by COL will lower the MDR space 
requ i rement . Use of filtering of MDR input will also 
1 owe r this space requ i rement . Use overlaid MDR. 
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MDR - 



- UNABLE TO ALLOCATE RESOURCE. SRT BUFFER 



Explanation : MDR was unable to get needed virtual space 
for a dynamic structure in pass 1 1 . 



User Act i on : Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend . Use SET /MAXEXT to allow suf f i ci ent extension. 
Use o f filtering of MDR input will 1 owe r this space 
requirement. Use overlaid MDR . 



MDR -- UNABLE TO ALLOCATE RIB 

Explanation : MDR was unable to sufficiently extend 
itself to provide space for initialization of pass I . 
This indicates a severe shortage of necessary dynamic 
space. 

User Act i on : Ensure MDR is checkpoi ntabl e . Ensure the 
partition where MDR runs has enough space for MDR to 
extend . Use SET /MAXE XT to allow sufficient extension. 
Use of smaller buffers by COL will 1 owe r the MDR space 
requ i remen t . 



MDR -- UNABLE TO OPEN INPUT FILE 

Explanation : An I/O error occurred when MDR attempted 
to open the logfile. 

User Act i on : Correct the condition and rerun MDR . 



MDR -- UNABLE TO OPEN OUTPUT FILE 

Expl anati on : An I/O error occurred when MDR attempted 
to open the report file. 

User Acti on : Correct the condition i nd i cated by F . ERR 
and rerun MDR. 



MDR -- UNKNOWN INFO TYPE RECORD FOUND 

Explanation : A corrupted logfile , or a file not 
p roduced by COL is being used as MDR input. 

User Act i on : Use a di f f erent file for MDR input. 
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MDR UNKNOWN RECORD TYPE 

Explanation : A corrupted 1 ogf i 1 e , or a file not 
produced by COL is being used as MDR input. 

User Acti on : Use a di f f erent file for MDR input. 



MDR VT UNIT NUMBER EXCEEDS PREDEFINED MAXVT 

Explanation: An I $C VT , I $E L V , or I$UCB record was 
encountered for a virtual termi nal with a unit n umbe r 
which exceeds the predef i ned maximum MAXVT. 

User Acti on : Rebuild MDR with a 1 a rge r value defined 
for this maximum. See sections 7 . 4 and 7.5. 



MDR -- VTO: DCB OR UCB NOT PROCESSED BY INF 

Explanation : An I $C VT or I $ E L V record was encountered 
without processi ng the I $DC B and I$UCB records for VTO : 
(prototype VT database) . Thi s indicates the database 
for the VT : devices was loaded after invoking the COL 
task. 

User Acti on : See section 7.3. 
MDR -- WILDCARD NOT ALLOWED IN FILESPEC 

Expl anati on : The MDR command conta i ns a w i 1 d c a r d . 

User Acti on : Reenter the command without any wildcards. 



MDR WRONG FOLLOWING PRIMARY RWB FOUND 

Explanation : An inconsistency was detected in MDR 1 s 
pass I dynamic data . 

User Acti on : * * * SPR ! 
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3.2.5 Using CLF 



CLF is used to copy logfiles produced by COL. The three modes 
of CLF operation are: 

o Buffer Transfer Mode, 

which copies a logfile from either disk or tape , to 
disk o r tape , maintaining the logfile format which MDR 
uses for input. 

o FCS Record Transfer Mode , 

which copies a 1 o g f i 1 e from either disk or tape, 
producing an output file with variable length FCS 
records. 

o Read-only Mode , 

which reads the logfile, computes o verf 1 ow and buffer 
counts, but does not create a new file. 

The general procedure for using CLF is: 

>RUN CLF 

CLF> [OUTFILE/sw =] LOGF ILE/sw 

Note that the output f i 1 espec and "=" are optional . I f these 
are not specified, CLF will operate in read-only mode, 
producing no output file. 

When FCS mode is specified (by the /FCS swi tch) , the records 
have the format specified in appendi ces A through D . The first 
word o f each record is the record ID which uniquely identifies 
the record type. I f overflows occur within the data stream , a 
speci al "overflow record " is placed in the output file at the 
point where records we re lost due to overf 1 ow . The f o rma t of 
this (length = 4. bytes ) record is: 




600(8) = overflow record ID 



count o f records lost by o verf 1 ow a t 
this point 



When the /FCS switch is used, the default output f i 1 espec is 
changed to TRACE. FCS. 

After CLF has completed reading the input file, the run 
stati sties will be reported to C LF ' s T I : . 
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CLF Switches 

Switch defaults 

output : SY :TRAC E . LOG/- AP/DE :800/-FCS 
input : SY :TR AC E . LOG/DE :800/RW/SK :0 



Output Swi tches Descri pti on 



/AP /-AP APpend file to the end of magtape . CLF 

will space over a 1 1 existing files on the 
magtape and write the new file starting at 
the current end-of - vol ume point. 

/DE :nnnn Sel ect s output magtape DEnsity, 800 or 1600 

/FCS[ :nn] / - FC S Sel ects FCS sequenti al records in the 

output file, and changes the default output 
f i 1 espec to TRACE. FCS. If " :nn" is not 
specified, all record types will be copied. 
I f " :nn " is spec i f i ed , only sel ected record 
types wi 1 1 be wri tten . " n n " is the total 
for desi red record types : 



01 - overflow records 

04 - system conf i gurati on records 

10 - task event hook records 

20 - system metric records 

40 - user inserted records 

100 - load disk o verl ay records 

200 - call di recti ve processor records 



Input Swi tches 



/DE :nnnn Sel ects input magtape DEnsity , 800 or 1600 

( i gnored unless /RW is al so used) 

/RW /-RW ReWi nd tape input file before opening 

/SK:nnn SKi p nnn files when openi ng tape input file 
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CLF Messages 



The CLF messages are issued to the T I device under which CLF is 
run. Thi s section di scusses the messages which CLF can issue. 

CLF -- #### BUFFERS READ 

CLF -- #### RECORDS READ 

CLF -- #### BUFFERS WITH OVERFLOW 

CLF -- #### RECORDS LOST BY OVERFLOW 

Explanation: This stati sties message is output at the 
compl et i on of each run of CLF , indicating the stati sties 
about the input file. 

User Act i on : None . 

CLF -- #### FCS RECORDS WRITTEN 

Explanation : This stati sties message is output when CLF 
produces an FCS output file. 

User Acton : None . 

CLF -- DSW :###### F. ERR :###### I0SB :###### ###### PC :###### 

SP :###### 
CLF -- STK :###### ###### ... 

Expl anati on : Thi s is a status message whi ch gives 
detai 1 of the internal state of CLF at the time when an 
error is detected . Thi s message is al ways f ol 1 owed by 
one of the messages discussed below, whi ch descri bes the 
actual error condi ti on . 

User Acti on : See action specified for the message 
i ssued immedi ately after this status message . 



CLF -- COMMAND READ ERROR 

Explanation: An I/O error occurred while reading the 
command line. 

User Acti on : Reenter the command. 



CLF -- COMMAND SYNTAX ERROR 

Explanation: The command has improper syntax. 
User Action: Reenter the corrected command. 
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CLF -- COMPLETION ERROR IN INPUT READ 

Explanation : an I/O error occurred while reading the 
input file. This condition, which may be symptomatic of 
a corrupted 1 ogf i 1 e , will be treated as end-of-f i 1 e. 

User Action: Check F.ERR and IOSB for error cause, or 
use another logfile. 



CLF ERROR ASSIGNING INPUT DEVICE 

Explanation : CLF was unable to assign a LUN to the 
input file. 

User Action : Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct . 



CLF -- ERROR ASSIGNING OUTPUT DEVICE 

Expl anati on : CLF was unable to assign a LUN to the 
o u t p u t f i 1 e . 

User Action : Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 



CLF -- ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 

Explanation : An I/O error occurred when attempting to 
open a file on magtape. 

User Action: Ensure the drive is mounted foreign if 
logfile format is used for that file. Ensure the output 
drive is selectable , and not write 1 ocked. Correct the 
error indicated by DSW or IOSB. 



CLF -- ERROR CLOSING INPUT FILE 

Expl anation ; An I/O error occurred when closing the 
input file. 

User Acti on : None. 
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CLF -- ERROR CLOSING OUTPUT FILE 

Explanation : An I/O error occurred when truncating or 
closing the output file. 

User Act i on : Correct the condition and rerun CLF, or 
manually unlock the output file. 



CLF -- ERROR IN INPUT READ QIO 

Explanation : An I/O error occurred while reading the 
i nput file. Thi s condi ti on , whi ch may be symptomatic of 
a corrupted logfile, wi 1 1 be treated as end-of-fi le. 

User Act i on : Check DSW for cause . Rerun using another 
logfile if necessary. 

CLF -- ERROR READING MPB 

Expl anati on : An I/O error occurred when readi ng the 
first block of the logfile. 

User Act i on : Correct the condition and rerun. 



CLF ERROR WRITING TO OUTPUT FILE 

Explanation : An I/O error occurred when writing to the 
output file. 

User Act i on : Correct the condition and rerun . 



CLF -- INPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation : A syntax error was detected in the input 
f i 1 e s p e c . 

User Act i on : Reenter the corrected command. 



CLF INVALID DENSITY SELECTED , 800 OR 1600 ONLY 

Explanation : A magtape den s i ty other than 800 or 1600 
was s pec i f i ed . 

User Action : Reenter the command with a correct 
dens i ty . 
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CLF INVALID INPUT DEVICE TYPE 

Explanation : An attempt was made to read a file not on 
disk or tape . Disk and tape are the only acceptabl e 
medi a for 1 og f i 1 es . 

User Act i on : Do not use CLF to read f i 1 es not on disk 
o r tape . 

CLF -- INVALID MPB FOUND 

Explanation: The first block of the input file does not 
pass certain val i d i ty tests whi ch ensure the file is a 
logfile. This may be caused by a corrupted or obsol ete 
logfile, o r a logfile p roduced by an i ncompat i b 1 e 
version of COL. f 

User Acti on : Use a di f f erent logfile. 

CLF INVALID OUTPUT DEVICE TYPE 

Explanation : An attempt was made to write in logfile 
f o rmat to a device other than disk or tape . 

User Act i on : Only write logfile format to disk or tape. 

CLF -- MORE THAN ONE INPUT FILESPEC NOT ALLOWED 

Explanation : The command has i mproper syntax . 

User Act i on : Reenter the corrected command . 

CLF -- MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 

Explanation : The command has improper syntax . 
User Acti on : Reenter the corrected command . 

CLF -- MPB NOT FOUND - NOT TRACE FILE 

Expl anati on : The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile. 

User Act i on : Use a di ff erent logfile. 
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CLF -- OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation : A syntax error was detected in the output 
f i 1 es pec . 

User Acti on : Reenter the corrected command. 



CLF -- OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation : The first block of the input file does not 
pass certai n validity tests which ensure the file is a 
1 o g f i 1 e . This may be caused by a corrupted or obsolete 
1 ogf i 1 e . 

User Act i on : Use a d i f f erent 1 ogf i 1 e . 

CLF -- TRUNCATED INPUT FILE RECORD 

Explanation : The end of a buffer was reached before al 1 
record s in that buffer were processed . This indicates a 
corrupted 1 og f i 1 e . 

User Act i on : Use a di ff erent 1 ogf i 1 e . 



CLF -- UNABLE TO OPEN INPUT FILE 

Explanation : An I/O error occurred while opening the 
i nput file. 

User Acti on : Correct the condi ti on and rerun. 



CLF -- UNABLE TO OPEN OUTPUT FILE 

Explanation : An I/O error occurred while opening the 
output file. 

User Act i on : Correct the condition and rerun . 



CLF UNKNOWN RECORD TYPE 

Explanation : An un known record I D was found in the 
file. 

User Act i on : Use a di ff erent 1 ogf i 1 e . 
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CLF WILDCARD NOT ALLOWED IN FILESPEC 

Explanation : A wi 1 dca rd was found in the command . 
User Action : Reenter the command without wildcards. 



3.2.6 Using OVL 



OVL is used to read a logfile and p roduce a report showi ng the 
disk resident overlay acti vi ty for a task . 

A memory-resident overlay segment is loaded from disk the first 
t i me that the segment is referenced . I f a task has memory- 
resident o verl ays , OVL will count their initial 1 oads in the 
overlay report . Subsequent memory-resident overl ay "loads" 
will not be counted , since a disk load is not performed . 

OVL has two input files : 

1 ) A m a p f i 1 e for the task whose disk resident overl ays 
are to be analyzed. 

2) A 1 ogf i le. 

In addition , the taskname swi tch /TS rtsknam must be appended to 
the logfile speci f i cati on . I f the taskname speci f i ed by 
/TS rtsknam is a generic taskname , e.g., . . . X YZ , then al 1 
overl ay hook records with the same gener i c taskname will be 
analyzed for the overl ay report. I f the taskname is not 
gener i c (not of the form . . . XYZ) , then only the hook record s 
whose tasknames exactly match the /TS rtsknam taskname wi 1 1 be 
analyzed for the overlay report . 

The overl ay report lists all the segment names for a task and 
prints the n umber of times each segment was loaded. 

I n addition , you can trace each over 1 ay load by using the /TR 
switch on the output file. As each overlay hook record is 
read , the segment name and the number of times that segment has 
been loaded up to that point will be printed. 

The command syntax for OVL is: 

>RUN OVL 

0VL> OUTFILE/SW = MAPFILE , LOGF ILE/TS :tsknam 
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OVL Switches 



Switch defaults 

output : SY .-TRACE. RPT/-TR 

input mapf i 1 e : SY .-TRACE .MAP 

input logfile: SY :TRAC E . LOG/DE .-800/RW/SK :0 



Output Switches Descri pti on 


/ TR /-TR 


Print a trace of each overlay segment , giving 
the segment name and the n umber of times the 
segment has been loaded up to that point. 


Input Switches 
(to logfile) 


/ TS .-tsknam 


This switch is required. I f "tsknam" is of 
the f o rm . . . X YZ , a 1 1 hook records with same 
generic task name will be included for 
overlay analysis; if "tsknam" is not of the 
form . . . X YZ , then only hook records with 
tasknames exactly matchi ng "tsknam" will be 
i ncl uded for overlay analysis. 


/DE :nnnn 


Selects input magtape DEnsity, 800 or 1600 
( i gnored unless /RW is al 1 used) 


/RW /-RW 


Rewind tape input file before opening 


/SK :nnn 


Skip nn n files when opening tape input file 
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OVL Messages 



The OVL messages are issued to the T I device under which OVL is 
run. This section discusses the messages which OVL can issue. 



OVL 
OVL 



DSW :###### F.ERR :###### IOSB :###### ###### PC :###### 
SP :###### 

STK :###### ###### ... 

Explanation: This is a status message which gives 
detai 1 of the internal state of OVL at the time when 
an error is detected . This message is always f ol 1 owed 
by one of the messages discussed below, which 
describes the actual error condition. 



User Acti on : See action specified for the 
i ssued i mmedi ately after this status message. 



message 



OVL -- COMMAND READ ERROR 

Explanation : An I/O error occurred while reading the 
command line. 

User Act i on : Reenter the command . 



OVL 



COMMAND SYNTAX ERROR 

Explanation : The command has improper syntax. 
User Act i on : Reenter the corrected command . 



OVL COMPLETION ERROR IN INPUT READ 

Explanation : an I/O error occurred whi 1 e readi ng the 
input file. This condition , which may be symptomati c 
of a corrupted logfile, will be treated a s 
end-of-file. 

User Acti on : Check F.ERR and IOSB for error cause , or 
use another logfile. 



OVL -- ERROR ASSIGNING INPUT DEVICE 

Explanation: OVL was unable to assign a LUN to the 
i nput f i 1 e . 

User Action: Check DSW and F.ERR for cause. Ensure 
the f i 1 e s p e c syntax is correct . 
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OVL -- ERROR ASSIGNING OUTPUT DEVICE 

Explanation : OVL was unable to assign a LUN to the 
output file. 

User Act i on : Check DSW and F.ERR for cause . Ensure 

the filespec syntax is correct . 



OVL -- ERROR ATTACHING , POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 

Explanation : An I/O error occurred when attempting to 
open a file on magtape . 

User Act i on : Ensure the drive is mounted foreign. 
Correct the error i ndi cated by DSW or IOSB. 



OVL -- ERROR CLOSING INPUT FILE 

Explanation; An I/O error occurred when closing the 
input file. 

User Act i on : None . 

OVL -- ERROR CLOSING OUTPUT FILE 

Explanation : An I/O error occurred when closing the 
output file. 

User Act i on : Correct the condition and rerun OVL or 
manually unl ock the output file. 



OVL -- ERROR IN INPUT READ QIO 



Explanation : An I/O error occurred while reading the 
input file. Thi s condi ti on , which may be symptomat i c 
o f a corrupted 1 ogf i 1 e , will be treated as 
end-of-file. 

User Action: Check DSW for cause . Rerun using 
another 1 o g f i 1 e if necessary . 



OVL -- ERROR READING MPB 



Explanation: An I/O error occurred when reading the 
first block of the logfile. 

User Action: Correct the condition and rerun. 
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OVL -- ERROR PARSING MAP FILE 

Explanation : OVL could not parse the speci f i ed file 
into overlay segment names and semgent block numbers . 

User action : Input a valid map file. 

OVL -- ERROR PRINTING OVERLAY SUMMARY 

Explanation: An I/O or formatting error occurred when 
attempting to print the summary section of the overl ay 
report . 

User action : Correct the condi ti on and rerun. 

OVL -- ERROR PRINTING OVERLAY TRACE 

Explanation : An I/O or f ormatti ng error occurred when 
attempti ng to print the trace secti on of the overl ay 
report . 

User action : Correct the condi t i on and rerun . 

OVL -- INCONSISTENCY BETWEEN MAP FILE AND LOG FILE 

Explanation : The overl ay block numbers in the logfile 
for task speci f i ed by /TS :tsknam do not appear in the 
map file. 

User Act i on : Be sure the map file is correct for a 1 1 
tasks in logfile with generi c taskname speci f i ed by 
/TS rtsknam. 

OVL -- INPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation : A syntax error was detected in the input 
f i 1 espec . 

User Act i on : Reenter the corrected command. 

OVL -- INVALID DENSITY SELECTED , 800 OR 1600 ONLY 

Explanation : A magtape densi ty other than 800 or 1600 
was speci f i ed . 

User Act i on : Reenter the command with a correct 
den s i ty . 
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OVL -- INVALID INPUT DEVICE TYPE 

Explanation : An attempt was made to read a file not 
o n disk or tape . Disk and tape are the only 
acceptable media for 1 ogf i 1 es . 

User Acti on : Do not use OVL to read files not on disk 
or tape . 

OVL -- INVALID MPB FOUND 

Explanation : The first block of the input file does 
not pass certai n validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsol ete logfile. 

User Act i on : Use a different logfile. 

OVL MORE THAN TWO INPUT F ILESPECS NOT ALLOWED 

Explanation : The command has improper syntax . 

User Act i on : Reenter the corrected command. 

OVL -- MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 

Expl anati on : The command has i mp roper syntax . 

User Act i on : Reenter the corrected command . 

OVL -- MPB NOT FOUND - NOT TRACE FILE 

Explanation : The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. Thi s may be caused by a corrupted or 
obsolete logfile. 

User Act i on : Use a different logfile. 

OVL -- OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation : A syntax error was detected in the 
output f i 1 espec . 

User Act i on : Reenter the corrected command . 
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OVL -- OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Acti on : Use a di f f erent logfile. 

OVL -- TRUNCATED INPUT FILE RECORD 

Explanation : The end of a buffer was reached before 
all records in that buffer were processed . Thi s 
i ndi cates a corrupted logfile. 

User Acti on : Use a di ff erent logfile. 
OVL -- UNABLE TO OPEN INPUT FILE 

Expl anati on : An I/O error occurred whi 1 e open i ng the 
input file. 

User Action: Correct the condition and rerun. 
OVL UNABLE TO OPEN OUTPUT FILE 

Explanation : An I/O error occurred while opening the 
output file. 

User Act i on : Correct the condition and rerun . 
OVL -- UNKNOWN RECORD TYPE 

Explanation : An unknown record I D was found in the 
file. 

User Act i on : Use a di ff erent logfile. 

OVL -- WILDCARD NOT ALLOWED IN FILESPEC 

Expl anati on : A wi 1 dcard was found in the command. 
User Acti on : Reenter the command wi thout wi 1 dcards . 
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3.2.7 Writing User Information to the Logfile 



The performance of an appl i cati on task can be measured 
by i ns t r ument i n g the application task with a special 
directive and sub-function code : 
GIN$ 7 ,P1 ,P2 ,P3 ,P4 ,P5 ,P6 ,P7 ,P8. 

At each occurrence of this directive, the SPM- 1 1M-PLUS 
performance monitor is invoked and a hook record of 
type H$USER is written to the logfile. The eight 
parameters P 1 to P8 are bi nary wo rd s whose values can 
be set to any value the user desires. The hook record 
written to the logfile is specified in appendix A , 
Page A-28. 

The user can copy the logfile using CLF to obtain a 
logfile with H$USER records in FCS variable length 
record format. Data reduction programs can then be 
written using the FCS record file as input. 

Examp 1 e : 

GIN$C 7 ,100 ,200 ,300 ,400 ,500 ,600 ,700 ,1000 

wi 1 1 result in a n H$USER record with parameters 100 , 
200 , 300 , 400 , 500 , 600 , 7 00 , and 1000 wri tten to the 
logfile. 

To dump a stream of H$USER records in a performance 
report , you run MDR and use the /DM:40 switch. If you 
only want the H $ U S E R records dumped, the command 
syntax is: 

MDR> output = i nput/DM :40/LI :0/S I :0 

To copy a stream of H$USER records imbedded in a 
logfile with other record types , you can run CLF as 
follows : 

>CLF output /FCS :40 = i nf i 1 e. 
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CHAPTER 4 
DATA COLLECTION AND 
REDUCTION PROCEDURES 



COL and MDR are complementary tools which can be used to 
collect large amounts of performance data and interpret the 
data to a great degree of preci si on . Both COL and MDR have a 
number of parameters and swi tches which provide flexibility in 
both coll ecti ng and interpreting the data. In the f ol 1 owi ng 
sections we descri be how to utilize the parameters of COL and 
MDR to collect the best possi bl e set of data to analyze your 
computer system. 



4.1 DATA COLLECTION PROCEDURE 

There are a number of questi ons you should answer before 
running COL to collect data : 

o Length and type of measurement interval? 

o Resou rce types enabled for data col 1 ecti on? 

o Device cl asses enabled for data collection? 

o Tasks enabled for data collection? 

o System metrics enabled? 



4.1.1 Measurement Peri od 

The measurement per i od is def i ned as the t i me during which COL 
is collecting data . Typi cal 1 y this time is one conti nuous t i me 
i nterval ; however, it may consi st of a number of time interval s 
piecewise added together. 
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Under most conditions , you should select a conti nuous measure- 
ment period. This is done by runni ng COL either in MANUAL mode 
or AUTOSTOP mode . 

MANUAL mode should be used when : 

o There is an operator available to termi nate COL. 

o You est i mate the logfile space available is sufficient 
to contain al 1 the data collected for the measurement 
period. 



AUTOSTOP mode should be used when : 

o An operator is not avai 1 abl e to termi nate COL , 

o You want to run COL for a fixed amount of time 
(AUTOSTOP on TIME) . 

o You want to set a limit on the amount of logfile space 
used (AUTOSTOP on BUFFER) . 



Under some conditions , parti cul arly if the system is under 
heavy acti vi ty for 1 ong peri ods of time , COL wi 1 1 collect too 
much data given the available logfile space . To reduce the 
logfile space used , you can run COL in REPEAT mode . However , 
you shoul d do so careful ly . The chief concern when running COL 
in REPEAT mode is that " i ncompl ete intervals" may resul t if a 
task o r operation is outstandi ng exactly when COL starts or 
stops data col 1 ecti on . For example , if you start COL preci sel y 
when a task is active and has an I/O operation queued to the 
disk, an i ncompl ete i nterval will be flagged by MDR for both 
the task i n vocati on and for the I/O operati on . This condition 
does not i n v a 1 i d a t e other information in the performance 
report , it just "leaves out " some i n format i on which potenti ally 
may be valuable. You can minimize the number of i ncompl ete 
intervals by minimizing the number of times COL enables or 
disables data col 1 ecti on for a measurement period. 

Let's say you want to col 1 ect data during a no rmal 8-hour 
daytime shift and you have only one 2400 foot magtape available 
for the logfile. However , you estimate that if COL runs all 
day, about two 2400 foot tapes will be needed . What you need 
to do is cut the amount of data collected in half. Consider 
the f ol 1 owi ng alternative measurement schemes: 

o Sample time = 1 minute; Time between samples = 
1 minute. 



12/81 



DATA COLLECTION AND REDUCTION PROCEDURES 4-2 



o Sample time = 30 minutes; Time between samples = 
30 minutes. 

o Sample time = 2 hours ; Time between samples = 
2 hours. 



Scheme 1 will usual 1 y r e s u 1 t in the highest number of 
i ncompl etes , yet it probably will not "miss" any important 
system act i v i ty . Scheme 3 will probably resul t in the 1 owe st 
number of incompletes , yet it is vulnerable to missing 
important i nterval s of system act i v i ty . Scheme 2 will probably 
resul t in a 1 ow number of i ncompl etes , yet it has a good chance 
of capturing all periods of important system activity. 

What we're observi ng here is a n old probl em in commun i cat i on s 
systems : How fast do you sampl e a signal to be able to 
reconstruct the signal from the sampled data? 1 n our case, the 
probl em is: how fast do you sample the workl oad in order to 
reconstruct it? 

I n communication systems , you sampl e the signal at twice the 
hi ghest frequency in the si gnal . In computer systems , it would 
be reasonabl e to sample the workl oad at twice the highest 
frequency of vari ati on in the workl oad . Thu s if you observe 
the workl oad to fluctuate up and down about four times per 
shift, then 8 sampl es per shift (every 30 minutes) woul d reduce 
the amount of data and yet collect sufficient data to 
reconstruct the workl oad . 



4.1.2 Resource Types 

Normal 1 y you want to col 1 ect data for all resource types (CPU , 
memory , I/O) . I f the amount of data coll ected is too large, 
you can sel ect one resource type per measurement period and run 
a n umber of measurement periods. 

The hooks are grouped accordi ng to resource ty pe . To select a 
particul ar resource type , you select the correspondi ng hook 
group. 



4.1.3 Device Classes 

The device classes are: Di rectory , Sequential , Terminal, and 
Othe r . I f you want to measure the resource contention for a 
device , sel ect it for data coll ecti on . Normal ly the disks are 
shared devices and should be selected. I f the line pri nter is 
spooled and attached to the despool er task you may not need to 
collect usage data for it. Similarly , termi nal s are normally 
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singly used by one task at a time ; the measurement resul ts may 
not be useful from a resource contenti on poi nt of view. 



4.1.4 Tasks 

The tasks selected for data col 1 ecti on are the definition of 
the wor kl oad that you want to measure. For exampl e , if you 
want to analyze the application workload, select all the tasks 
in that workl oad and deselect the system service tasks such a s 
F11ACP , MCR . . . , and QMG . . . . On the other hand , if you want to 
measure the system resources that a particular Fl 1AC P is 
consuming, enable only Fl 1AC P and disable al 1 other tasks. 



4.1.5 System Metri cs 

Normally system metrics should be enabled with a s amp 1 e 
i nterval of 60 seconds . I f you want to save 1 o g f i 1 e space and 
report paper , longer sample intervals may be used . 



4.2 DATA REDUCTION PROCEDURE 

Once you have a 1 og f i 1 e on disk or tape , you are ready to read 
the logfile with MDR and reduce the data to a usabl e perf o r- 
mance report . A guide to reading the performance report is 
given in Chapter 5. 

The data reduction procedure should consist of a number of 
steps methodi cal 1 y performed. A general guideline is to first 
obtai n a number of overviews of the system act i v i ty during the 
entire measurement period and then print detailed analyses of 
the subset measurement interval s of i nterest . For exampl e , if 
during an 8 hour shift there were two interval s of peak 
act i v i ty , from 9 to 1 1 a.m. and from 2 to 4 p.m., you should 
first run MDR with /LI :0 to get a system metri cs scan of the 
entire 8 hour shift , and then run MDR with / AF and /BF to get a 
report of only the peak morning activity and again with /AF and 
/BF to get only the peak afternoon acti vi ty . The general 
procedure is a s f ol 1 ows : 

o Run MDR with /LI : for entire 1 ogf i 1 e . 

Identi fy the intervals of i nterest and record their 
endpoi nts of t i me using the KW11-P clock t i mestamps 
pr i nted above the system metri cs . 

o Rerun MDR once for each subset measurement i nterval 
using /AF and /BF with the /LI : 2 switch. 
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This will give both system and task summaries . 
Identi fy the largest consumers of resources and record 
thei r tasknames . 

o Rerun MDR with /ll -A or /LI : 5 and /TS for the tasks 
desired. 

Observe a deta i 1 ed analysi s of the particular tasks 
whi ch consumed the resources and the times when these 
resources were consumed . 
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CHAPTER 5 
READING THE 
PERFORMANCE REPORT 

5.1 PERFORMANCE REPORT DATA 

When reading this section, refer to Append i x F , which contains 
a sample performance report. 

The performance report cons i sts of four secti ons : 
o Measurement Parameters 
o System Configuration 
o System Metrics 
o Task Metrics 

5.1.1 Measurement Parameters 

The measurement parameters are read from the Mon i tor Pa rameter 
Block (MPB ) which is the first block of the logfile. The MDR 
task extracts the i nf ormati on from it and prints the measure- 
ment parameters on the first page of the performance report . 
The i terns pri nted a re : 

o Label . 

o Measurement mode. 

o Buffer type , partition , number and size, 

o Resources selected for System Metrics, 

o TI filter device (if selected), 

o Tasks selected for data collection. 
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Devices selected for data col 1 ecti on . 
Hooks enabled. 
MDR command line 



5.1.2 System Conf i gurati on 

The system configuration information is conta i ned in the 
Information Records and di recti y follows the MPB in the 
1 ogf i 1 e . I f the /SC switch is speci f i ed , the MDR task wi 1 1 
extract the i nformation from these records and print it to the 
1 o g f i 1 e . The information printed is: 

o The primary pool (DSR) size in bytes , the executive 
feature mask words , and seconda ry pool size in 32 word 
blocks. 

o A list of the partitions in the system when COL was 
acti vated . 

o A list of the controllers and units in the system when 
COL was activated. 

o A list o f the tasks i nstal 1 ed in the system when COL 
was activated. 

o A list of the active checkpoi nt files and their sizes 
when COL was activated. 



5.1.3 System Metri cs 

The system metri cs are system-wi de measurements of CPU usage , 
pool usage , the usage of a selected partition , checkpoi nt file 
usage , and the usage of a selected device. Measurements are 
made for each sampling i nterval and the results written to the 
1 ogf i 1 e . The length of the sampl i ng interval is selected in 
the SMPGEN.CMD procedure . The system metri cs are : 

o CPU Usage 

For each sampl i ng interval , counters are kept for the 
total times spent in kernel and idle states . The 
rema i nde r of the sampling interval time is assumed to 
be user state . To depict CPU usage, a hi stogram is 
pri nted on the performance report . Each 1% of t i me 
spent by the CPU in user mode is represented by a 
single 1 etter " U " . Each 1% of time spent by the CPU 
in kernel mode is represented by a single 1 etter " K " . 
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The user time is left justified and grows from left to 
right; the kernel time is right justified and grows 
from right to left. If any blank spaces exist in the 
line, they represent CPU idle time. 

Pool Usage 

At the end of each sampling interval , COL scans the 
RSX- 1 1M-PLUS primary and seconda ry pools and measures 
the percentage of each pool used. The percentage of 
pool used is represented by a histogram, where each 
"P" represents 1% of primary pool usage and each " S" 
represents 1% of secondary pool usage. 

Partition Usage 

The user selects a partition to be monitored via the 
COL switch /PR :pa r n am . At the end of each sampling 
interval, COL scans the partition data structures for 
the sel ected partition to measure the percentage of 
the memo ry in use in the partition. The percentage of 
memory used in the partition is represented by a 
histogram, where each " M" represents 1% of partition 
usage . 

Checkpoint File Usage 

When COL is act i vated , it scans the checkpoi nt file 
list and record s a list of al 1 active checkpoi nt files 
and thei r si zes . 

At the end of each sampling interval , COL scans the 
checkpoi nt file list and measures the percentage of 
all active checkpoi nt file space in use. I f there is 
more than one checkpoi nt file, COL sums the space in 
all checkpoint files to compute the percentage. The 
percentage of checkpoint file space used is repre- 
sented by a h i stog ram , where each "C " represents 1% of 
checkpoint file space usage . 

Device Usage 

The user sel ects a device to be mon i tored v i a the COL 
switch /DV :ddnn . For each sampl i ng i nterval , COL 
tallies al 1 the I/O request times for the sel ected 
devi ce to get the percentage of time that the I / 
device was in use during the sampling interval. The 
percentage of time the device was used is represented 
by a hi stogram , where each " D " represents 1% of device 
usage t i me for the sampl i ng interval . 
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addi ti on , if the device is a Files-11 disk and is 
mounted native, the number of disk blocks used on the 
vol ume is computed a t the end of the sampling 
interval. The percentage of disk space used is 
represented by a hi stogram where each "B" represents 
1% of the total vol ume space used . 



For each sampl i n g interval , the hi stograms for CPU, pool , 
memory , checkpoint file space , and device are clustered 
together into six successi ve lines on the report . 

The end of each sampling interval is t i mestamped and printed in 
two formats : KW11-P time and RSX-1 1M-PLUS system time . 

The KW11-P time is pri nted as two octal numbers : the 1 eft 
number is the high order part and the right number is the low 
order part . The corresponding RSX-11M-PLUS system time is 
pri nted as HRS :M I N :SEC . TENTHS . 

The KW11-P t i mestamp can be used to : 

o Correl ate an individual task report page ( whi ch has 
the same form of t i mestamp ) with a particular system 
metri c line. 

o Select a particular measurement interval of interest 
by rerunni ng MDR using the / AF and /B F switches. 



The total s for CPU kernel time , CPU idle time and device busy 
t i me are given for each measurement i nterval . 

The last item in the system metri cs secti on is the "Total Data 
Reducti on Period". Thi s is the total time for whi ch data was 
reduced . I f the report was generated using the / AF and /BF 
swi tches , only the data reduced between /AF and /BF is counted . 



5.1.4 Task Met r i cs 

Level s of Task Summa r i zat i on 

The task metr i cs describe the usage of the resources in the 
system on a task-by-task basis. There are a n umber of levels 
of summari zati on available in the performance report , which 
enables the user to choose between a very detailed report or a 
shorter summari zed report . The levels of summarization and 
their correspondi ng switches are a s f ol 1 ows : 
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o Individual Task Invocations (/LI, -4 or /LI :5 ) 

An individual task invocation is defined as a single 
run of a task, that is, the time between an executive 
Run Task event and an executive Exit Task event (the 
exact placement of" the hooks for these events is 
specified in Appendix A). A complete set of task 
metrics will be printed for each task invocation. If 
most or all tasks in the system are enabled for data 
collection, a report containing individual task 
invocations may be quite long, 

o Task by TI Summary (/LI :3) 

In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2 , section 
2.2.2) and the same TI are grouped together when the 
statistics are computed. The task metrics then reveal 
the measurements summed across all tasks with the same 
generi c taskname from the same T I . 

o Task Summary (/LI :2) 

I n this level of s umma ry , the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) are grouped together when the statistics are 
computed. The task metrics then reveal the measure- 
ments summed across all tasks with the same generic 
taskname . 

o Sy stem-Wi de Summa ry (/LI : 1 ) 

I n this level of s umma ry , the task metrics for a 1 1 
tasks in the system that were enabled for data 
collection are grouped together when the statistics 
are computed. The task metrics then reveal the 
measurements summed across all tasks in the system. 



Task Metric Data 

The foil owi ng data is presented in the performance report for 
al 1 levels of task summari zati on . 

o Generi c TASK 

The generic taskname (see Chapter 2, Section 2,2.2) is 
printed on the top of the page to identify the task 
for which the data applies. 
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Elapsed Times 

The elapsed time is the t i me from a Run Task event to 
an Exit Task event . 

Number of Task Invocati ons 

The Number of Task Invocations is the number of times 
that a Run Task event occurred for the task . I f the 
COL task is started while a task is in progress , the 
Run Task event wi 1 1 not be recorded in the 1 ogf i 1 e for 
that task . When the task exits, an Exit Task event 
wi 1 1 be recorded to the logfile. When MDR reads an 
Exit Task event wi thout a correspondi ng Run Task 
event , i t reports an " i ncompl ete " i n vocati on in the 
Number of Task Invocati ons line. 

Memory Times 

There are three memory ti mes : 
I n (memory ) 

Out (memory) - includes t i me wai ti ng for memory on 
initial task load and a 1 1 time checkpoi nted 
(wai ti ng and stopped) . 

Wait (memory) - i ncl udes time waiting for memory on 
initial task load and time checkpoi nted (waiting 
only) . 



Memory Size in K Words 
Size o f the task reg i on . 
Space-Time Product 

The space-time product is the amount of memory that a 
task uses integrated over the t i me that the memory was 
used . Each i nc rement of memory used (in K words) is 
mul ti pi i ed by the time (in SECs ) that the i ncrement 
was used , and al 1 products are summed to get the 
space-time product . I f a task changes its size vi a an 
Extend Task directive, the corresponding change in 
memory usage is computed . 
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o ACP Counts 

The AC P Counts are tallied across all ACPs in the 
system. They are not broken down by separate ACP. 

There are seven categories of ACP functions printed on 
the performance report . They are : 

Access/Deaccess 

These functions are: Access File for Read, Access 
File for Read/Wri te , Acces s File for Read/Write/ 
Extend , Deaccess File, Connect Logical Link, and 
Di sconnect Logi cal Link, and Close Out LUN . 

Create/Del ete 

These functions are: Create File, Delete File and 
Truncate File. 

- Read/Write 

These functions are : Read Virtual Block, Write 
Virtual Block , Recei ve Message and Transmit 
Message. 

Di rectory 

These functions are: Find File Name in Directory, 
Enter File Name in Di rectory and Remove File Name 
from Di rectory . 

File Attr i bute 

These functions are: Read File Attri butes and Write 
File Attri butes . 

Extend 

This is the Extend File function. 

- Other 

These f uncti ons are al 1 AC P functions other than 
those listed above , such as : Unlock Block , User 
Magtape Control Function and Ne two r k Control 
Function. 
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o Memory Res i dency 

The Memory Res i dency count is incremented each t i me a 
task successfully al 1 ocates memory for an initial task 
load or for a checkpoi nt read . 

o CPU Timesl i ces 

A CPU Timeslice is the t i me between a Load Task 
Context event and a Save Task Context event , minus the 
idle time accrued during that period. Note that if a 
task issues a directive and the processor switches to 
kernel mode , the correspondi ng time in kernel mode is 
charged to the active task ' s CPU timeslice. Al so , if 
an interrupt occurs whi 1 e a task's context is active, 
the correspondi ng kernel mode time is charged to the 
active task's CPU timeslice. 

o Initial Loads 

Initial Loads is the number of Initial Task Load 
events for the task . The USAGE times indicate the 
time it took the 1 oader task to load the task ; the 
WAIT times indicate how long a task's load request was 
in the loader task's queue. 

o Checkpoi nt R + W 

Checkpoint R + W is the number of Checkpoi nt Read and 
Checkpoint Write events for the task . The USAGE times 
indicate the time it took the 1 oader task to check- 
point ( read or write) the task . ( Note : the USAGE 
t i mes do not indicate how 1 ong a task was check- 
poi nted . This information appears under "Memory 
Times" on the task metric page . ) 

o DDnn Ovly Loads 

DDnn Ov 1 y Loads is the number of overl ay read ( 1 0. LOV) 
QIOS the task issued to device DDnn . 

o DDnn QIQs 

DDnn QIOs is the number of 1 ogi cal QIOs a task i ssued 
to device DDnn . Please note the f ol 1 owi ng caveats : 

DDnn Ovly Loads is i ncl uded in this count , s i nee 
10. LOV is a Logical block QIO. 
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- Task IO.RVB and IO.WVB (virtual) Q I Os which are 
successfully and entirely mapped by the executive 
or F11ACP to I0.RLB and 10.WLB (Logical) QIOs are 
included in this count . 



- Task IO.RVB and IO.WVB (virtual) QIOs which are 
sent to F11ACP , and whi ch are performed by F11ACP 
on behalf of the task (partially mapped, multiple 
transfers), are not included in this count. This 
logical block I/O is charged to F11ACP. 

- The 10. ATT, I0.DET and IO.KIL QIOs arejno 1 inc ' iuded 
in this count. 

Drivers for devices with the characteristic UC .QUE 
may directly process an I/O request without the IRP 
being queued. This will cause an incomplete 
measurement of Usage and Wait times, (e.g., VT : , 
TT :) 

USAGE Times 

The USAGE times i ndi cate how long a task used a resource. 



WAIT Times 

The WAIT times indicate how long a task was waiting for the use 
o f a resource . 



SERVICE Times 

The SERVICE time is the USAGE time plus WAIT time which 
occurred for each resource request . Note that the minimum 
SERVICE time is not necessari ly equal to the minimum USAGE time 
plus mini mum WAIT t i me , since the mi n i mum USAGE time may have 
occurred for a di f f erent resource request than the resource 
request whi ch had the minimum WAIT time. The same applies to 
the maximum. 



ARRIVALS PER SECOND 

The mean task rate is the number of resource requests issued by 
a task divided by the task's elapsed time. It tells, from a 
task's point of view, the rate of resource requests issued by 
a task. The mean system rate is the number of resource 
requests i ssued by a task divided by the data reduction period. 
It tells , from a resource' s point of view, the rate of resource 
requests i ssued by a task . 
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Resource Met r i cs 

For each resource used by a task , the f ol 1 owi ng metrics are 
pri nted on the report : 

o Count 

The number of times a task used a resource . 

o Tota 1 Time 

The total t i me during which a task used the resource 
(equal to the sum of all resource usage intervals). 

o % Resident Time 

% Resi dent Ti me is (Total Time/Resident Ti me) * 100%. 

o Minimum 

The smal lest interval during which a task used a 
resource. 

o Mean 

The ari thmeti c average of all resource usage intervals 
for a task. 

o Maximum 

The 1 argest i nterval during which a task used a 
resource . 

o Coefficient of Variation 

The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval . 

o % Resource 

% resource is the total time a task used the resource 
divided by the total time of the Data Reducti on Period 
(total resource ti me available). 

o Incompl ete 

If the 1 ogf i 1 e does not contai n a "compl ete" set of 
events needed to define an interval , MOR wi 1 1 tally 
the interval as an "incomplete". For example, if MDR 
reads a I/O Done event from the 1 ogf i 1 e for a certai n 
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task and device and there is no corresponding Get I/O 
Packet event for the task and device, MDR will regard 
the I / interval a s a n incomplete. Incompl ete 
intervals can occur if COL starts data collection 
while an operation (interval) is already in progress. 

The only data recorded for incomplete i nterval s is the 
count ; no timing i n f o rmat i on is computed since the 
i n f o rmat i on is not precise. 

Incomplete intervals are printed in lieu of the % 
resource metri c if the / IC switch is specified. 
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CHAPTER 6 
RESOURCES USED 
BY SPM-1 1'M-PLUS 



The purpose of this sect i on is to give an estimate of t he 
resources used by the COL and MDR tasks. 



6.1 RESOURCES USED BY COL 
o CPU 

When a task metric hook is encountered , from 50 to 7 5 
instructions are executed at system level ( P R = , 
$STKDP = 0) before returni ng to the main f 1 ow of the 
executi ve . 

o Executi ve I -space 

Following a SYSGEN, SPM-1 1M-PLUS occupies 
approximately 290 words of executive I-space. This is 
mainly accounted for by the hooks, hook dispatcher and 
the KW11-P handler. 

o Primary Pool 

When the COL task is activated approximately 260 words 
of primary pool are used . 

o Physical Memory 

The COL task occupies about 3. 5K words of physical 
memory. The COL buffers (either in a static common or 
dynami c region) can vary from 0.5K words to 32K words . 
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o 1/0 Requests 

The COL task issues a FCS WRITES to write a buffer to 
disk; it issues a Q 1 0$ to write a buffer to magtape. 
The rate of I/O requests generated by COL depends on 
the system activity that COL is tracing. 



6.2 RESOURCES USED BY MDR 
o Memory 

The code and static data of MDR requires varying 
amounts of memory depending upon which version is 
built. See the TASK IMAGE SIZE in MDR. MAP. 
Additional space is required for I/O buffers and 
dynamic structures which are manipulated within MDR 1 s 
virtual address space. MDR will automatically extend 
its virtual space as needed to accommodate these 
structures. Typically MDR will require an additional 
8KW for all the dynamic storage. 

o Pool 

All MDR I/O is singly buffered , and synchronous , 
minimizing the use of pool. 

o I/O 

Each pass of MDR reads a single file and writes to the 
report file. During pass I the RESOURCE . TMP file is 
also bei ng written . Termi nal I/O is used for command 
in Put, and error reporti ng . The DRS task wi 1 1 have up 
to 7 files concurrently opened for I/O . 
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CHAPTER 7 



SPM-1 1M-PLUS 



USAGE NOTES 



7.1 TASKBUILDING COL 

COL must be linked to the supervisor-mode library [1,1]FCSFSL. 
This means that supervisor-mode support must be included in the 
system at SYSGEN. 



7.2 COL BUFFERS 

When COL starts up it copies three system lists to the 1 og 
file: 

1) TCBs 

2) PCBs 

3) DCBs-UCBs 

There must be enough buffer space to store the 1 a rgest of these 
three system lists, otherwi se COL will print the error message 
COLMSG -- INFORMATION RECORD ALLOCATION FAILURE. 

Before COL is left to run unattended for long periods of time, 
COL should be run for 5 to 1 minutes under a ty p i ca 1 heavy or 
peak system workload and the consol e t e r m i n a 1 s h o u 1 d be 
monitored for the occurrence of o verf 1 ow errors , i.e., COLMSG 
-- BUFFER OVERFLOW. If buffer overf 1 ows occur , the buffer size 
for COL can be i nc reased by using the /BF switch ( see Chapter 
3 , sect i on 3.2.2). 

Another cause of COL o verf 1 ows may be sma 1 1 disk file extent 
sizes. When COL attempt s to write a buffer to tTFe 1 ogf i 1 e , 
F 1 1AC P may have to do a n extend file operation before the 
actual data write can be done . The time it takes F11ACP to 
extend a file may be long, and COL may overf 1 ow as a result of 
this. To remedy this situation , two swi tches have been built 
into COL : 

o Initial File Si ze /IF 

o Extend Fi 1 e Si ze /EX 
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If an estimate can be made of the maximum logfile si ze before 
COL is run , it is best to preal locate al 1 the logfile space via 
the /IF switch . In this case COL wi 1 1 not need Fl 1AC P to do 
any extend file operat i ons during its run and this may prevent 
overf 1 ows from occurring. 

7.3 STATE OF SYSTEM AT COL STARTUP TIME 

When COL starts up , it copies the TCBs , PCBs , DCBs and UCBs in 
RSX-11M-PLUS to the 1 ogf i le. The MDR task 1 ater refers to 
these data structures to derive the necessary context for 
printing a performance report . 

To assure that MDR wi 1 1 have al 1 the context it needs to print 
the report , you should insure that the f ol 1 owi ng condi tions are 
sati sf i ed before starting up COL: 

o Al 1 tasks installed 

If you want to disable a task for data collection, 
that task must be i nstal 1 ed when COL starts up. If 
the system supports mul ti -user protection , then the 
f ol lowing is true : if you di sable a task of the form 
. . . XYZ , then al 1 mul ti -user copies of that task wi 1 1 
also be disabled for data col 1 ecti on . 

o Al 1 partitions set up 

If you want memory metrics kept for a partition, the 
partition must be set up 

(via SET /MA I N=XYZPAR :m :n :type) before starti ng COL. 
o Al 1 drivers loaded 

I f you want the I/O metrics kept for a device-unit, 
the driver managing that device-uni t must be 1 oaded 
before starti ng COL . 

The MDR program is not capable of analyzing a logfile 
whi ch contains task event records for an I/O devi ce , 
but no system configuration information for that 
device. To ensure that unusabl e 1 o g f i 1 e s are not 
c reated , no device driver database may be loaded while 
the task — COL is active. 
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o Al 1 devi ces mounted 

If you want the correct ACP taskname for a mounted 
vol ume to be pri nted on the performance report , the 
volume must be mounted before starti ng COL . Other- 
wise, MDR will print a " pseud o " taskname for the AC P . 

Example : I f the device OKI : is mounted to the F 1 1 AC P 
task after data collection is in progress for COL, MDR 
wi 1 1 print the pseudo name DK1***ACP on the report . 

o Al 1 checkpoi nt files allocated 

I f you want the system metri cs for checkpoi nt file 
usage , be sure to al 1 ocate a 1 1 checkpoi nt files with 
the AC S command before starti ng COL. 



7.4 TASKBUILDING MDR 

MDR will run on processors with or wi thout ha rdwa re FPP ( f 1 oat- 
ing point processor) support . I f your processor does not have 
hardware FPP , it must minimally have hardware EIS instructions. 

You must taskbui 1 d MDR to ref 1 ect the type of hardware (FPP or 
EIS) on your processor . You can build MDR ei ther overlaid or 
non-overlaid with both FPP and E I S versions. To build MDR , 
invoke the build command file: 

>@MDRTKB 

This command file will prompt you to build any of the four 
a va i 1 abl e versions : 

1 . FPP support , overl a i d 

2. FPP support , non-overl aid 
3 . E I S support , overlaid 

4 . E I S support , non-overl ai d 
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You can change certai n MDR defaults by edi ti ng the taskbui 1 d 
command file produced by MDRTKB.CMD. The comments in the MDR 
build file will prompt you for changing the defaults. The 
def aul ts which can be changed are : 

o Number of lines per page in REDUCE. RPT file 

o Default value for /LI switch 

o Default value for /SI switch 

o Default magtape logfile density (/DE) 

o Def aul t value for /DM swi tch 

o Whether MDR automati cal ly spawns DRS 

o The maximum unit n umbe r of a VT in the measured system 



7.5 MAXIMUM VT : UNIT NUMBER SUPPORTED BY MDR 

MDR has the capability to process the dynamic creation and 
deletion of virtual terminals during a period of data 
collection. One aspect of the implementation of this feature 
is that MDR must pre-allocate the data structures which 
describe al 1 the VTs while processing the I $UCB for VTO : . Thus 
on a system with no VT : support these structures will not be 
allocated. Although device unit numbers may range from to 
377 (8), RSX-11M-PLUS always assigns the lowest possible unit 
number to a newly created VT:. Since each such data structure 
used by MDR requires 6 words, allowing for 377(8 ) VTs would 
require more than 1.5 K Words of MDRs virtual space. To 
reduce this excessive use of space to a much smaller value, 
40(8), is used as the maximum VT : unit number which MDR will 
recognize. Should this prove insufficient, MDR may be rebuilt 
with the parameter MAX VT i ncreased . 



7.6 PERFORMING REDUCTION UNDER BATCH 

MDR may not be run in BATCH if any of the switches /NT, /NU, 
/TS, or /UC is used. This occurs because MDR uses "read with 
prompt" to obtain the filter parameters, but the VT : driver 
does not support this function. Since I/O error at terminals 
are often correctable, or due to operator error (break key), 
MDR will repeatedly retry I/O which the VT : driver does not 
support. This causes an endless loop. 

Manual intervention to run the DRS pass is impractical when 
running MDR under a batch processor. 
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The tasks CLF, DRS , and MDR terminate their execution via the 
EXITS directive. This implies that the resulting status will 
always be EX$SUC even when a n error occurs. 



7.7 NECESSARY UFD TO RUN MDR 

The intermediate files used by MDR wi 1 1 always be created in 
the di rectory SY .-[current U IC ] . Therefore to run MDR. this 
d i recto ry must exist , on a mounted Fi 1 es- 1 1 disk. 



7.8 DEVICES FOR TI : FILTER 

Al 1 devices which are specified in the MDR T 1 : filter ( / NU or 
/UC ) must be known to MDR via the I $UCB records . Thus to use a 
VT : in this filter, the VT : (or BATCH Processor) must be 
created before starti ng data col lection. 



7 . 9 MANUALLY EXECUTING THE DRS PASS 

MDR cannot determine whether DRS has completed successfully or 
with errors . I f errors are 1 i kely in this pass (e.g. , available 
disk space is minimal ) manual i nterventi on to execute the DRS 
pass may be desirable. MDR will issue instructions for this 
manual operation if either of the following two conditions are true 

o MDR is built with the 6BLPAT which prevents automatic 
spawn of DRS 

o The task . . .DRS is not installed when MDR is runni ng. 



7.10 TASKBUILDING CLF 

General 1 y CLF need not be t a s k b u i 1 1 since it is supplied as a 
task image. Howe ve r to change def aul ts or apply patches, the 
build command file is i n voked : 

>@MDRT KB 

The defaults which may be changed are: 

o default magtape density 

o default value of the /FCS:nn switch 
(if specified a s / FC S ) 
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7.11 POSSIBLE HANGING OF CLF 



If CLF is writing an FCS output file to the null device ( N L : ) , 
and no records are actually written , CLF wi 1 1 hang in WAITFOR 
state when attempting to close the output file. To recover 
from this error , it is necessary to abort CLF . 



7.12 USE WITH LAYERED PRODUCTS 

SPM-11M-PLUS i nserts hooks into the RSX-11M-PLUS executi ve at 
standard places where the executive does al locations and 

deallocations of resources . 

SPM-11M-PLUS measures kernel CPU time by hooki ng the standard 
interrupt save ( $ I NTS V , $ I NTS E , $ I NTSC ) and system exit 
($D IRXT) points. 

If any 1 ayered product or user pr i vi 1 eged component uses 
nonstandard techniques for resource al 1 ocati on or i nterrupt 
entry , the SPM- 1 1M-PLUS measurements will be inaccurate. 

For example , DEC NET uses a nonstandard interrupt save routine , 
which means the kernel CPU t i me measurement will be inaccurate. 



7.13 REPORTING PROBLEMS AND ERRORS 

A Software Performance Report ( SPR ) is used to report probl ems , 
errors , or suggested enhancements concerning SPM-1 1M-PLUS . 

Whenever possible, the following information should be 
submi tted with the SPR : 

o A map of the failing component 

o The MPB source f i 1 e (TRACE. PAR) 

o The 1 ogf i 1 e on Magtape (TRACE.LOG) 

o The faulty performance report (REDUCE. RPT) 

o The faulty CLF output file on Magtape 

o The f aul ty OVL output file. 

All media wi 1 1 be returned. 
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APPENDIX A 
HOOK RECORD 
DEFINITIONS 



NOTE : All record offsets in this appendix 
are expressed in octal bytes . 

Al 1 record lengths are expressed in 
decimal bytes. 



( 

12/81 HOOK RECORD DEFINITIONS A-]. 



1.0 H$CDRP - CALL DIRECTIVE PROCESSOR 



1.1 LOCATION 



DRDS P . MAC 

After $EMTRP : :DIRSV$ 

After 50$: MOV R5.R2 

Follow MOV $HEADR,R4 



1.2 DATA COLLECTION 



1.2.1 Storage Dependencies - 



STKTCB (Current Task KB) 
$DICSV (Di recti ve ID Code) 



1.2.2 Record Format 



Hook I.D 



Timestarnp 



Taskname (RAD50) 



TI UCB Address 



DIC 




2 



12 
14 



1.2.3 Record Length 
14 . bytes. 
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2.0 H $ RTS K - REQUEST TASK TO RUN 



2.1 LOCATION 



REQSB .MAC 

After $TSKRP : : 

After 1$ : 

Fol low MOV 



R2 ,T.UCB(RO) 



2.2 DATA COLLECTION 

2.2.1 Storage Dependencies 

R0=TCB address 

2.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname (RAD50) 



TI UCB Address 



Request UIC 





2 

6 

12 
14 



2.2.3 Record Si ze - 
1 4 . bytes . 
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3.0 H$XTSK - TASK EXIT 

3.1 LOCATION 

DRE I F . MAC 

After $ C E X 1 T : : 

Fol 1 ow 130$ : MOV $TKTCB ,R0 

3.2 DATA COLLECTION 

3.2.1 Storage Dependencies - 
$TKTCB=TCB address 

3.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname (RAD50) 



T I UCB Address 



I d 1 et i me 




2 



12 
14 



3.2.3 Record Length 
16 . bytes . 
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4.0 H$SCTX - SAVE CONTEXT OF TASK 



4.1 LOCATION 



SYSXT.MAC 
After RESCH 
Fol 1 ow 



CLR 
73$ 



@$RQSCH 
MOV H . GARD ( R3) ,R2 



4.2 DATA COLLECTION 

4.2.1 Sto rage Dependenci es - 
$TKTCB (Current Task TCB) 

4.2.2 Record Format - 



Hook I.D. 



Time st amp 



Taskname (RAD 50) 



TI UCB Address 



I d 1 e t i m e 




2 

6 

12 

14 



4.2.3 Record Length 
1 6 . bytes 
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5.0 H$LCTX - LOAD CONTEXT OF TASK 

5.1 LOCATION 

SYSXT.MAC 

After RESCH : CLR @$RQSCH 

Follow 120$: MOV H . GARD ( R2 ) ,R0 

5.2 DATA COLLECTION 

5.2.1 Storage Dependenci es - 
$TKTCB (Current Task TCB) 

5.2.2 Record Format - 

Hook I.D 
Timestamp 
Taskname (RAD50) 



TI UCB Address 



Id 1 et i me 

( 

5.2.3 Reco rd Length 
1 6 . bytes 




2 
6 

12 

14 
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6.0 H$USTP - UNSTOP TASK 

6.1 LOCATION 

REQSB .MAC 

After $E XRQN : :B IT #T2.STP*2!T2.STP,T.ST2(R0) 

Follow BIC #T2.STP*2!T2.STP,T.ST2(R0) 

6.2 DATA COLLECTION 

6.2.1 Storage Dependencies - 
R0=TCB address 

6.2.2 Record Format - 

Hook I.D. 
Ti mestamp 2 

Taskname (RAD50) 6 

TI UCB Address 12 

6.2.3 Record Length - 
12. bytes . 
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7.0 H$QAST - QUEUE AST TO TASK 



7 . 1 LOCATION 



7.2 



REQSB .MAC 

After $QASTT : :ADD 
Follow 

REQSB .MAC 

After $QUEXT : : 
Follow Mov R2, RO 

DATA COLLECTION 



#T . ASTL ,R0 
BEQ 5$ 



7.2.1 Storage Dependenci es 
RO=TCB address 



7.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname ( RAD 50 ) 



TI UCB Address 




2 



12 



7.2.3 Record Length 
1 2 . bytes . 
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8.0 H$E XTK - EXTEND TASK 



8.1 LOCATION 



DREXP.MAC 

After $DREXP : : 
Fol 1 ow 71$ 



MOV Rl ,P. SIZE(RO) 



8.2 DATA COLLECTION 



8.2.1 Storage Dependencies - 

$TKTCB=TCB address 
RO=PCB address 



8.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname ( R AD 50 ) 



TI UCB Address 



Partition Si ze (P.SWSZ) 




2 



12 



14 



8.2.3 Record Length 
14 . bytes. 
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9.0 H$QPAR - QUEUE REQUEST FOR PARTITION 



9.1 LOCATION 

RE QSB . MAC 

After $TSKRP : : 
After 4$ : 

Fol 1 ow MOV 



9.2 DATA COLLECTION 



9.2.1 Storage Dependencies - 
R1=PCB address 



9.2.2 Record Format - 



Hook I .D. 



Ti mestamp 2 



Taskname (RAD50) 6 



TI UCB Address 12 



9.2.3 Record Length - 
12. bytes . 



R3 ,R1 

-, 
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10.0 H$QLDR - QUEUE TASK LOAD REQUEST TO LOADER QUEUE 



10.1 LOCATION 



RE QSB . MAC 
After $LOADT : : 
Follow 50$ 



MOV $ L D R P T ,R0 



10.2 DATA COLLECTION 

10.2.1 Storage Dependenci es 
R1=PCB address 

10.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname (RAD50) 



TI UCB Address 



P. SIZE 



P.STAT 




2 



12 
14 
16 



10.2.3 Record Length - 
1 6 . bytes . 
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11.0 H$GLDR - GET REQUEST FROM LOADER QUEUE 



11.1 LOCATION 

LOADR . MAC 

After $LOADR : :C Al 1 $SWSTK ,40$ 
Follow 5$ : MOV Rl , R3 



11.2 DATA COLLECTION 

11-2.1 Storage Dependencies 
R 1 = PC B address 

11.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname ( RAD50) 



TI UCB Address 




2 



12 



11.2.3 Record Format 
12. bytes . 
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12.0 H$F LDR - FINISH LOADER REQUEST 



12.1 LOCATION 



LOADR .MAC 

After $LOADR : :CA1 1 $SWSTK ,40$ 
Follow 81$ : CA1 1 $SWST K , $LOADR 



12.2 DATA COLLECTION 

12.2.1 Storage Dependencies 
R4=PCB address 

12.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname (RAD50) 



TI UCB Address 





2 



12 



12.2.3 Record Length 
1 2 . bytes . 
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13.0 H $ R L P R - RELEASE PARTITION 

13.1 LOCATION 

RE QSB . MAC 

After $RLPAR : : 
Follow 

13.2 DATA COLLECTION 

13.2.1 Storage Dependenci es - 
Rl = PCB address 

13.2.2 Record Format - 



Hook ID 
Ti mestamp 



Taskname (RAD50) 



TI UCB Address 
T.ST2 



13.2.3 Record Length - 
14. bytes . 



( 

BNE $NXTSK 



( 


2 

6 ( 

12 
14 

( 
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14.0 H $ QD R V - QUEUE I/O PACKET TO DRIVER 



14.1 LOCATION 



DRQIO.MAC 

After $DRQ I : : 
Follow $DRQRQ : :MOV 



U.SCB(R5) ,R4 



14.2 DATA COLLECTION 



14.2.1 Storage Dependencies - 

R 1 = I R P address 
R5=UCB address 



14.2.2 Record Format 



Hook I.D. 



Ti me st amp 



Taskname ( RAD 50 ) 



TI UCB Address 



UCB Address 



Function code 



LUN 



IRP Address 





2 

6 

12 
14 
16 
20 
22 



14.2.3 Record Length 
20. bytes . 
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15.0 H$6PKT - DRIVER OR AC P GETS 

15.1 LOCATION 

IOSUB.MAC 

After $ G T P K T : : 
After 12 7$: 
Fol 1 ow 

DISPAT.MAC (F11ACP) 

After .START : : 
Follow 

15.2 DATA COLLECTION 

15.2.1 Storage Dependencies - 
Rl-IRP address 

15.2.2 Record Format - 

Hook I.D. 
Ti mestamp 

Taskname ( RAD50) 

TI UCB Address 
IRP Address 

15.2.3 Record Length - 
14. bytes. 



AN I/O PACKET 

( 

MOVB U.UNIT(R5) ,R2 

* 

MOV $HEADR ,R5 



2 
6 

( 

12 
14 
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16.0 H$ I ODN - I/O DONE PROCESSING 



16. 1 LOCATION 



1 OSUB . MAC 

Fol 1 ow $IODON : :MOV 



U.SCB(R5) ,R4 



16.2 DATA COLLECTION 

16.2.1 Storage Dependenc i es 
R4 = SCB Address 

16.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname ( R AD 50 ) 



TI UCB Address 



I RP Address 




2 



12 
14 



16.2.3 Record Length - 
14 . bytes . 
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17.0 H$ I OF N - COMPLETE I/O POST PROCESSING 

{ 

17.1 LOCATION 

IOSUB.MAC 

Fol low $ I OF I N : : 

17.2 DATA COLLECTION 

17.2.1 Storage Dependencies - 
R3= IRP address 

17.2.2 Record Format - 

Hook I . D . 
Ti mestamp 

Taskname (RAD50) 

TI UCB Address 
IRP Address 

17.2.3 Record Length - 
14 . bytes . 




2 

6 

12 
14 
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18.0 H$QAC1 - QUEUE I/O PACKET TO AC P 



18.1 LOCATION 



DRQ I . MAC 

After $DRQIO 
Follow 



MOV U. ACP(R5) ,R0 



18.2 DATA COLLECTION 

18.2.1 Storage Dependencies 
R 1 = I R P address 

18.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname (RAD50) 



TI UCB Address 



UCB Address 



Function Code 



LUN 



IRP Address 




2 



12 
14 
16 
20 
22 



18.2.3 Record Length - 
20 . bytes. 
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19.0 H$QAC 2 - QUEUE I/O PACKET TO AC P 



19.1 LOCATION 

I OSUB . MAC 

After $GTPKT 
Fol 1 ow 95$ : 



19.2 DATA COLLECTION 

19.2.1 Storage Dependenc i es 
R1=IRP address 

19.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname (RAD50) 



TI UCB Address 



UCB Address 



Functi on Code 



LUN 



IRP Address 




2 

6 

12 
14 
16 

20 
22 



19.2.3 Record Length - 
20. bytes . 
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20.0 
20.1 



20.2 
20.2.1 

20.2.2 



H$CRVT - CREATE VIRTUAL TERMINAL 
LOCATION 



DRCRV.MAC 

After $DRCRV: 
After 70$ : 
Fol 1 ow 

DATA COLLECTION 

Storage Dependenc i es 

R1=DCB address 
Record Format - 



MOVB D.UNIT(Rl) ,2(SP) 



I$CVT 



UCB Address 



Unit Number 




2 



20.2.3 Record Length 
6 . bytes. 
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21.0 



H $ E L V T - ELIMINATE VIRTUAL TERMINAL 



21.1 LOCATION 

DRC R V . MAC 

After $DRCRV : : 
Fol 1 ow $D E AVT : : 

21.2 DATA COLLECTION 

21.2.1 Storage Dependencies 
RO = DC B Address 

21.2.2 Record Format 



MOV (RO) ,R0 




21.2.3 Record Length - 
4. bytes . 
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22.0 H$0VLY - LOAD OVERLAY 



22.1 



LOCATION 



DROIO.MAC 

After $DRQIO 
Fol 1 ow 



BNE IEOVR 



22.2 DATA COLLECTION 

22.2.1 Storage Dependenci es - 

R4 = <Add res s +2> of Overlay Relative Block Number 

22.2.2 Record format - 



Hook I.D. 



Timestamp 



Taskname ( R AD 50 ) 



TI UCB Address 



Relative Block Number 




2 
6 

12 
14 



22.2.3 Record Length - 
14. bytes . 
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23.0 H$S YE N - SYSTEM ENTRANCE 



23.1 LOCATION 

SYSXT.MAC 

After $ D I R S V : : 

Follow MOV SP,@$HEADR 

SYSXT.MAC 

After $ I NTS I : : 

Follow MOV SP , @$HEADR 

SYSXT.MAC 

After $INTSC : : 

Follow MOV SP, E?$HE ADR 



23.2 DATA COLLECTION 

23.2.1 Storage Dependencies - 
None 

23.2.2 Routi ne - 

Ti mestamps system entrance time $BSTIM. 

23.2.3 Record Format - 
None 
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24.0 H$SYXT - SYSTEM EXITS TO USER TASK 

24.1 LOCATION 

SYSXT.MAC 

After $DIRXT : : 

After 9$ : MOV (SP)+ ,R0 

Fol low MOV (SP)+ ,R3 

24.1.1 Storage Dependenci es - 
None 

24.1.2 Routine - 

Copies current clock time, subtracts system entrance 
time ( $BSTIM) , and adds the resul ting delta time to 
the total system time $TST IM. 

24.1.3 Record Format - 
None 
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25.0 H $ E I D L - ENTER EXECUTIVE IDLE LOOP 



25.1 LOCATION 

SYSXT.MAC 

After RESCH: 
After 30$: 

Follow CLRB @$CURPR 

25.2 DATA COLLECTION 

2 5.2.1 Storage Dependencies - 
None 

25.2.2 Routine - 

Copies current clock time, subtracts the system 
entrance time ($BSTIM) , and adds the resulting delta 
time to the total system ti me $TSTIM. Timestamps idle 
entrance t i me $B IDLE . 

25.2.3 Record Format - 
None 
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26.0 
26.1 



H$ X I D L - EXIT EXECUTIVE IDLE LOOP 
LOCATION 



SYSXT.MAC 

After 
Follow 



$QFORK 



CLRB 



$ I DLFL 



26.2 DATA COLLECTION 

26.2.1 Storage Dependencies - 
None 

26.2.2 Routine - 

Copies current clock time, subtracts the idle 1 oop 
entrance time ( $B IDLE ) , and adds the resulting delta 
time to the total idle time $ I OLE . Ti mestamps system 
entrance time $BSTIM. 

26.2.3 Record Format - 
None 
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27.0 H$USER - USER INFORMATION HOOK 



27.1 LOCATION 

DRG I N . MAC 

Follow $SFPMN : : 

27.2 DATA COLLECTION 

2 7.2.1 Storage Dependencies - 

$TKTC B (Current Task TCB) 
R3 = Address of DPB 

27.2.2 Record Format - 



Hook I . D . 





Timestamp" 


2 


Taskname ( RAD 50 ) 


6 


TI UCB Address 


12 


GIN$ Parameter 


1 


14 


GIN$ Parameter 


2 


16 


GIN$ Parameter 


3 


20 


QlW Parameter 


4 


22 


G I N$ Parameter 


5 


24 


GIN$ Parameter 


6 


26 


GIN$ Parameter 


7 


30 


G I N$ Parameter 


8 


32 



27,2.3 
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Record Length - 
28. bytes. 



HOOK RECORD DEFINITIONS 



A- 2 8 



APPENDIX B 
MPB DEFINITION 



Monitor Pa rameter Block 

The Moni tor Parameter Block (MPB) is the data structure which 
contains the measurement parameters . These measu rement 
pa rameters are defined by invoking the procedure @SMPGEN.CMD , 
whi ch produces : 

o The bi nary MPB file (f i lename.MPB) 

o The source MPB file ( f i 1 ename .PAR ) 

o The MPB saved answer file ( f i 1 ename . CMD ) 

The COL task reads the MPB and initializes its databases from 
the MPB . 

The 1 ength of an MPB in bytes is M.LGTH (def i ned by MPB DF$ in 
HKMAC . MAC ) 

The MPB has the f ol 1 owi ng format and contents : 



Parameter 


Offset 


Si ze(wds) 


Values 


MPB ID word ( I$MPB) 


M.PID 


1 


I$MPB 


Measurement label 


M.LABL 


32. 




Buffer Type 


M.BTYP 


1 


DYNAMICS 






S T A T I C = 1 


Buffer Count 


M.BCNT 


1 




Buffer Size ( bytes ) 


M.BSIZ 


1 




Buffer Si ze (64b bl k) 


M.BS64 


1 
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Parameter 

Buffer Partition Name 
SYS Partition Name 

Buffer Partition Add r . 

Buffer Partition Size 

Buffer Partition Flags 
Measurement Mode 

Sample Count (Buffers) 
Sample Interval Mag . 
Sample Interval Units 
Repeat Count 
Repeat Interval Mag . 
Repeat Interval Units 
Hook Bit Table 
I/O Selection Word 
Othe r Devices Sel . Word 
Device Class Mask 
Device Sel ecti on Mask 
Sys. Metri cs Samp . Int . 
Sys . Metri cs Partition 
Sys . Metrics Device 
T I Filter Device 
T I F i Iter Device Num . 
MPB Validation Word 
Task Selection Mask 
Task Sel ecti on Table 



Offset 
M.BPAR 
M.BPNM 
M.BPAD 
M.BTSZ 
M.BFLG 
M . MODE 

M.SCNT 

M.SINT 

M.SUNT 

M.RCNT 

M.RINT 

M . RUNT 

M.HTBL 

M . I OS 

M.OTHR 

M.CW1M 

M.CW1S 

M.SAMP 

M . PART 

M.DEVC 

M.TIDV 

M.TINM 

M. VALD 

M.TKS 

M.TTBL 



S i ze ( wds ) 
2 
2 



Val ues 



MANUAL=0 
AUTOSTOP 
REPEAT=2 



P$$VER 



28, 
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INFORMATION RECORD 
DEFINITIONS 



Inf ormati on Record 

The Information Record provides system context data which can 
be correl ated with the Hook Records to identify tasks , 
parti ti ons , and I/O device-units. 

In addition, there are Information Records which capture 
essenti al data when COL starts and stops data coll ecti on . 

For 1 engths of the following data structures , see the macro 
IBDEF$ in HKMAC .MAC . 

I $S Y S - System Common Information 



I$SYS 



Initial Pool Si ze 



$FMASK 




2 
4 



SFMASK+2 6 



Sys . Met . Dev . UCB Address 10 



SEC Pool Parti ti on Size 12 
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I$TCB - Task Control Block 



I $TCB 



I $TCB Record Size 




2 



TCB Address 



TCB Contents 



I $ PC B - Partition Control Block 



I $PCB 



I $PCB Record Size 



PCB Address 



PCB Contents 
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I $ DC B - Device Control Block 



I$DCB 



I $DCB Record Si ze 



DCB Address 



DCB Contents 




2 



I$UCB - Uni t Control Block 



I$UCB 



I$UCB Record Size 



UCB Address 



UCB Contents 
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I$CKP - Checkpoint File Information 



I$CKP 



CKP. File Device UCB Addr. 



CKP. File Size 



I $TMR - Start Data Col lection 



I $TMR 


System Time 


(Year) 


System Time 


(Month) 


System Time 


(Day) 


System Ti me 


(Hour) 


System Ti me 


(Mi nute) 


System Ti me 


(Second ) 


System Time 


(Tick) 


Ticks Per Second 


High KWll-P 


Ti me 


Low KWll-P Time 




2 
4 




2 
4 
6 

10 
12 
14 
16 
20 
22 
24 
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I $ STM - Stop Data Collection 
, ^ — 





I$STM 







System 


Time 


(Year) 


2 




System 


Time 


(Month) 


4 


a 


System 


Time 


(Day) 


6 




System 


Time 


(Hour) 


10 


f 


System 


Time 


(Minute) 


12 




System 


Time 


( Second ) 


14 




System 


Time 


(Tick) 


16 


( 


Ticks Per Second 


20 




High Kwll-P 


Ti me 


22 




Low Kwll-P 


Time 


24 




CPU Kernel 


Time (High) 


26 




CPU Kernel 


Time ( Low ) 


30 


- 


CPU Idle Time (High) 


32 




CPU Idle Time (Low) 


34 




Devi ce 


Usage Time (High) 


36 




Device 


Usage Time ( Low ) 


40 



12/81 INFORMATION RECORD DEFINITIONS C-5 



APPENDIX D 
SYSTEM METRICS 
RECORD DEFINITION 



System Metri cs Record 

The System Metri cs Record contains data which represents the 
system-wide usage of the CPU, pool , a sel ected memory 
partition , checkpoint file space , and a selected device. 
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S$M£T 



High Kwll-P Time 



Low KW11-P Time 



CPU Kernel Time (High) 



CPU Kernel Time (Low) 



CPU Idle Time (High) 



CPU Idle Time (Low) 



# Free Pool Nodes 



Total Free Pool Space (bytes ) 



Smal lest Pool Node (bytes ) 



Largest Pool Node (bytes ) 



Main Partition PCB Address 



Number of Subpartitions 



Total Space Used (32W blks) 



Total CKP.File Space 



Total CKP.File Space Used 



UCB Address of Device 



Device Usage Time (High) 



Device Usage Time (Low) 



Free Disk Blocks (High) 



Free Disk Blocks ( Low) 



SEC Pool Free (32 W blks) 



2 
4 
6 

10 

12 

14 

16 

20 

22 

24 

26 

30 

32 

34 

36 

40 

42 

44 

46 

50 

52 



SYSTEM METRICS RECORD DEFINITIONS 



APPENDIX E 
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1.0 DISK LOGFILE FORMAT 

A logfile on disk is a Files-11 file with the following format : 

VBN 
1 

N 
N+l 

2N 



M*N 
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BUFFER 
#1 



BUFFER 
#2 



BUFFER 
#M 



Each BUFFER has the following genera 1 format (byte 
offsets ) : 



Record Count 



Overflow Count 



x$xxx 



x$xxx 



Unused Space 



x$xxx is 1$ , H$ o r 
S$ record ID. 
See appendices 
A , B , C and D. 
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All BUFFERS are the same 1 ength . The BUFFER size in 512B 
blocks is derived from the BUFFER size in bytes which is 
stored in the MPB in BUFFER #1: 

BUFFER #1 Format (byte offsets ) 



Record Count 



Overflow Count 



I$MPB 



BUFFER Si ze (bytes ) 



I$SYS 



Note : 
I$MPB 
I $S YS 
x$xxx 



4+M.BSIZ 



the 
the 



i s 
i s 
is I $ , 
record 
See 
A , ! 



1st record 
2nd record 
H$ or S$ 
ID. 



appendices 
. , C and D. 



x$xxx 
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2.0 MAGTAPE LOGFILE FORMAT 



A magtape can contain one or more 1 ogf i 1 es . Each BUFFER is 
termi nated by an IRG. Each logfile is termi nated by a tape 
mark (EOF). The magtape is terminated by a double tape mark 
(EOF EOF) . Each BUFFER has the same format as for disk. 



BUFFER 
#1 



BUFFER 
#M1 

"TOT — 



end of logfile #1 



BUFFER 
#1 



BUFFER 
#Mn 

"TOT 

EOF 



end of logfile #n 
end of tape 
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3.0 FCS L06FILE FORMAT 



The CLF utility task can be used to convert a logfile from the 
formats speci f i ed in section 1 . and 2.0 to a file containing a 
stream of variable 1 ength FCS records . Each FCS record 
contains one record of type H$xxxx, I$xxxx or S$xxxx . The 
first word of each record contains the record ID , H$xxxx , 
I $xxxx or S$xxxx. The record formats are specified in 
Append i ces A , B , C and D . 

See Chapter 3 , Secti on 3.2.5 for using CLF . 
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APPENDIX F 
EXAMPLE PERFORMANCE 
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APPENDIX G 
EXAMPLE SMPGEN 



frSMPGEN 
>i 

>»*** Software Monitor Parameter GENeration coatand file *** 

>i 

>f**# Version 401 ttt 

> 5 

>rCopariaht ( C ) 1981 » 1982 Diaital Eouipwent Corporation* Maanardr Mass. 

>t 
>'> 

>i Initialize default parameters 

>} 

>* READ SAVED ANSWER FILE FOR DEFAULT ANSWERS? CY/NKN 

>i 

>i Select parameter cateSory > tape <esc> for help 

>i 

>* ENTER PARAMETER CATEGORY CS3J- 

> f 

>; LEGAL PARAMETER CATEGORIES ARE i 

>i HOOK TASK MODE LABEL 

>? BUFFER DEVICE SYSTEM DONE 

y r 

>* ENTER PARAMETER CATEGORY CS3S HOOK 

>i 

>i Select/deselect hook points 

>} 

>* CPU USAGE HOOKS? CY/NKY 

>* MEMORY USAGE HOOKS? CY/N] :N 

>* 1/0 DEVICE USAGE HOOKS? CY/N3JY 

>* USER INFORMATION HOOK? CY/NKN 

>* LOAD OVERLAY HOOK? CY/N] JY 

>* CALL, DIRECTIVE PROCESSOR HOOK? C Y/N3 ! N 

>9 

> ' Select parameter category? tape <esc> for help 

>'t 

>* ENTER PARAMETER CATEGORY CS3i BUFFER 

> t 

>} Setup buffer management para«eter» type <esc> for help 

>f 

>* ENTER BUFFER TYPE I D 5 DYNAMIC] CS RIO-73J 

>* ENTER NAME OF BUFFER MAIN (SYS) PARTITION CD S GEN] CS R50-63S BUFPAR 

>* ENTER NAME OF BUFFER COMMON/REGION CDSTRCPAR3 CS RS0-63J 

>* ENTER NUMBER OF BUFFERS CD RJ2.-8. DS2.3I 4 

>* ENTER BUFFER SIZE IN 512B BLOCKS CD RSI. -16. DJ8.3S 

>} 

>j Select parameter category, type <esc> for help 

>y 

>* ENTER PARAMETER CATEGORY CS3 t TASK 

>r 

> f Select/deselect tasks to be traced 

>i 

>* DO YOU WANT TO TRACE ALL TASKS? CY/N35 

>* DO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? C Y/N3 5 Y 
Enter one taskname per line. Terminate list by <CR> . 

>j 

>* ENTER NAME OF TASK NOT TO TRACE CS] J F11ACP 

>* ENTER NAME OF TASK NOT TO TRACE CS3 5 MCR. . . 

>* ENTER NAME OF TASK NOT TO TRACE CS] J QMQ. . . 

>* ENTER NAME OF TASK NOT TO TRACE CS3 5 LPPO 

>* ENTER NAME OF TASK NOT TO TRACE CS3 J TKTN 

>* ENTER NAME OF TASK NOT TO TRACE CS3J F11MSG 

>* ENTER NAME OF TASK NOT TO TRACE CS] 3 MTAACP 
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>* ENTER NAME OF TASK NOT TO TRACE [S3J, ...MCR 

>* ENTER NAME OF TASK NOT TO TRACE [S3 % DCL. . . 

>* ENTER NAME OF TASK NOT TO TRACE [S3 J ...DCL 

>* ENTER NAME OF TASK NOT TO TRACE [S3 { . . .HEL 

>* ENTER NAME OF TASK NOT TO TRACE [S3 J ...BYE 

>* ENTER NAME OF TASK NOT TO TRACE [S3i . . .MOD 

>* ENTER NAME OF TASK NOT TO TRACE [S3: ...DMO 

>* ENTER NAME OF TASK NOT TO TRACE [S3 : ...AT. 
>* ENTER NAME OF TASK NOT TO TRACE [S3! 

>; 

Select parameter category, tape <esc> for help 
>* ENTER PARAMETER CATEGORY [S3 t DEVICE 

>* DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? [Y/N3SN 
>} 

> i Select device types to be traced 

>} 

>* TRACE DISK (DIRECTORY DEVICE) I/O ACTIVITY? [ Y/N3 J Y 
>* TRACE TAPE (SEQUENTIAL DEVICE) I/O ACTIVITY? [ Y/N3 ! N 
>* TRACE TERMINAL I/O ACTIVITY? [Y/N3JN 
>* TRACE ALL OTHER DEVICES I/O ACTIVITY? [ Y/N3 i Y 

>i 

> i Select parameter category » type <esc> for help 

>} 

>* ENTER PARAMETER CATEGORY [S3 S MODE 

>i 

>> Define data col lection mode r type <esc> for help 

>} 

>* ENTER MODE [B I MANUAL3 [S R50.-8.3J 

>5 

> t 

>', LEGAL MODES ARE t 

>i MANUAL AUTOSTOP REPEAT 

>} 

>* ENTER MODE [D ! MANUAL 3 [S R J . -8 . 3 S / REPEAT 
>* ENTER SAMPLE TYPE CS RJO-63J 

>; 

>? LEGAL SAMPLE TYPES ARE t 

>» 

>i BUFFER TIME 

/* 5 

>* ENTER SAMPLE TYPE [S RS0-63J BUFFER 

>* ENTER NUMBER OF BUFFERS PER SAMPLE CD RSI. -32000. DJ16.35 400 

>* ENTER MAX. NUMBER OF SAMPLES [D R: 1 .-32000. D51.3: 25 

>* ENTER INTERVAL BETWEEN SAMPLES TIME UNIT [DJMIN3 [S RJ0-33S 

>* ENTER INTERVAL BETWEEN SAMPLES IN MIN [0 R51. -10000. DJ1.3J 45 

>i 

> r Select parameter category » type <esc> for help 

> f 

>* ENTER PARAMETER CATEGORY [S3 J SYSTEM 
>'t 

> i Select system metrics 

> I 

>* DO YOU WANT THE SYSTEM-WIDE METRICS? [ Y/N3 5 Y 

>* ENTER SYSTEM METRICS SAMPLING INTERVAL (SECS) [D RS15. -28800. D560.3J 300 

>t 

>i Select parameter category, type <esc> for help 

>; 

>* ENTER PARAMETER CATEGORY [S3 ' LABEL 

>i 

>5 Define 1 to 63 character label string, tape <esc> for help 

> i 

>* ENTER MPB LABEL [S RJ0-633S This is a sample SMPGEN. 

>i 

>) Select parameter category » type <esc> for help 
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••* ENTER PARAMETER CATEGORY CS3J DONE 

>'t 

i Write saved answer file and parameter source file 
■i Enter <esc> if no output file is desired 

* i 

* ENTER NAME OF SAVED ANSWER FILE CD : TRACE . CMD3 tSl J SAMPLE . CMD 

* ENTER NAME OF PARAMETER SOURCE FILE C D ! TRACE . PAR 3 CSK SAMPLE . PAR 

MAC SAMPLE=HKMAC» SAMPLE. PAR 
1KB 0PARBLD 

PIP SAMPLE. OBJ J */DE, PARBLD.CMD J* 

9 <EOF> 



12/81 



EXAMPLE SMPGEN 



APPENDIX H 
EXAMPLE INSTALLATION 



BACKUP RESTORE UTILITY VOl 



>tim 08: 19 12/9/81 

>run cnf 

> 

ENTER INPUT DEVICE C /C8R-NNN/VEC-NNN3 : mml 

ENTER OUTPUT DEVICE [ /CSR«NNN/VEC«NNNj ." dr:/vec-234 

>run Fmt 

> 

FMT>dr : 

*« WARNING - DATA WILL BE LOST ON DRO: ** 

CONTINUE? CY OR HI', y 

START FORMATTING 

OPERATION COMPLETE 

FMT>"2 
run bad 

> 

BAD>dr:/li 

BAD — DRO I BAD BLOCK FOUND - LBN= 248S3. 
BAD — DRO: TOTAL BAD BL0CK5- 1. 
BAD > A Z 
run br u 

> 

BRU>/bac : dri vs/ue 
from: mm: 
to: dr : 

BRU - STARTING TAPE 1 ON MMO : 

BRU - END OF TAPE 1 ON MMO : 

BRU - STARTING VERIFY PASS TAPE 1 ON MMO : 

BRU - END OF TAPE 1 ON MMO : 

BRU ~ COMPLETED 

BRUVZ 



RSX-11M-PLUS VOl BLB 124K 

>red dr:=sy: 
>red dr:=lb: 
>red dr:=sp: 

>MOU DR:R5X11MPBLG 
>§[ 2 r54 3BASTART.CMD 

>; 

>; RSX-11M-PLUS Distribution kit installation Phase-2 

> " 

>t The s yste« disk now contains on i y a b ootab 1 e baseline system. The 

>", remainder of the distribution kit must be loaded From the 

>>• distribution tape by BRU (the BACKUP and RESTORE utility). These 

>; instructions will suide you throuah the remainder of the 

>', installation process. 

>; 

>; 1) I t is important to specify the correct date and time. Use the 
>; format of "DD-MMM-YY HH:MM". 

>; 
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>* Please enter the date and time CSK 9-dtc-81 8 : 33 
>TIHE 9-dec-Bi 8:35 

> r 

>; 2) Now allocate checkpoint space For use by system utilites. 

>; 

>ACS SY.-/BLK5»i024. 

>; 

;•; 3) We will now brina online all devices which were SYSGEN-ed into 
>; this baseline imaae and which exist in your hardware system. 



ft 

>; 
>; 



If there is hardware in your s ystea occupyina a control 
reaister address which conflicts with a standard DEC real ster 
assignments, it is possible that the "CON ONLINE ALL" command 
>; misht cause a system crash. This is because a DIGITAL device 

>: driver is atumptins to Manipulate Foniin hardware or 

>; the CSR address assianments in your system are different 

>; from those assumed in this baseline conf iauration. On 

>; the first pass throush this file please answer "NO<CR>" 

>; to the following question. If such a mismatch exist s and 

>; a crash does occur/ reboot and answer " YES<CR>" to this 

>; question. Instructions will be provided to help 

>; circumvent the problem. 

>", 

>* Do you need to do manual conf iauration? CY/NKn 

> ? 

>CON ONLINE ALL 

>; 

;>; 4) We will now create directory entries for the files to be loaded 

.>; from the common backup set . The UFD commands will not be displayed . 

>; 
.* j 

>; 5) Please supply the ioaical name of the maanetic tape drive 
>; which should still contain the distribution tape. The 

>' name is of the form: 

>; 

:>; mmo : or 

>j HT2: etc... 

>; 

>« What is the device name of the distribution tape CSK A Z 
>e <EOF> 
>ins *bru 

>«ou mm : /f ar/dtni »BOO 

>bru /noinit /sup /dens :800 mm: dr : 
BRU - STARTING TAPE 1 ON MHO : 

BRU - END OF TAPE I ON MHO : 

BRU - COMPLETED 

>dmo m«: 

DHO — TTO: DISMOUNTED FROM MMO : »** FINAL DISMOUNT »*» 
08 : 39 : 23 «** mmo: — DISMOUNT COMPLETE 
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>8C2»343E)astart 

>; 

> ; RSX-1 IM-PLUS Distribution Kit installation Phast-2 

>; 

>? The system disk now contains only a bootable baseline system. The 

>; remainder of the distribution kit Must be leaded from the 

>; distribution tape by BRU (the BACKUP and RESTORE utility). These 

>' instructions will aui de you throuah the remainder of the 

>; installation process. 

>; 

>", l) It is important to specify the correct date and time. Use the 
>; format of "DD-MMM-YY HHIMM". 

>; 

>* Please enter the date and time tSK 09-dec-81 08142 
>TIHE 09-dec-Bl 08:42 

>; 

>; 2) Now allocate checkpoint space for use by system uti 1 i tes . 
>", 

>ACS SY:/BLKS*1024. 



ACS — CHECKPOINT FILE ALREADY IN USE ON DEVICE 

> ; 

>', 3) Me will now br ins online all devices which were SYSGEN-ed into 

>", this baseline inise and which exist in your hardware systam. 

:>; 

>' If there is hardware in your system occupying a control 

>f resister address which conflicts with a standard DEC rtai ster 

>.: assianmentE , it is possible that the "CON ONLINE ALL" command 

>; misht cause a system crash . Thi s is because a DIGITAL device 

>; driver is attemptina to manipulate f oreian hardware or 

>; the CSR address ass ianments in your system are different 

>; from those assumed in this baseline conf iauration. On 

>; the first pass throuah this file please answer "N0<CR>" 

>', to the foilowins question. If such a mismatch exists and 

>' r a crash does occur , reboot and answer " YES<CR>" to this 

>! question. Instructions will be provided to help 

> ! circumvent the problem. 

>; 

>* Do you need to do manual configuration? C Y/Nj '.n 



>C0N ONLINE ALL 

>; 

>; 3) Please supply the iosical name of the maanetic tape drive 



>? which should still contain the distribution tape. The 

>; name is of the form: 

> I 

>: HMO : or 

>; MTZ: etc... 



>* What is the device name of the distribution tape CSK mm." 
>* Is mm: written at 1GOO BP I ? EY/NKn 

> P 

>» G ) We will now mount that tape for access b y BRU . 

>MOU mm:/F0R/DENS=800 
>< 

>J 7) Ensure that the BRU task is installed. 

>; 

>? 

>; 8) We will now load the remainder of the distribution kit. 

>; 

>TIME 

08:43:22 09-DEC-81 

>BRU /REM /DENS : 800/ B AC : COMMON /NO I mm.' SY: 

BRU - STARTING TAPE i ON MHO Z 
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BRU ~ 


t n D Or ThPE 1 


ON mmo: 


BRU - 


MOUNT TAPE 2 


on mmo: 


BRU - 


MOUNT ThPE 2 


ON mmo : 


BRU - 


STARTING TAPE 


2 on mmo: 


BRU - 


END OF TAPE 2 


on mmo: 


BRU - 


COMPLETED 




>TIME 

09 : 04: 52 09-DEC-81 
>DM0 mm: 





DM0 — TTO: DISMOUNTED FROM MMO : *** FINAL DISMOUNT *** 
09:04:53 *** MMO : — DISMOUNT COMPLETE 

>; S) The installation of the RSX-1 1M-PLU5 kit is now complete. The next 
>' time this disk is booted, this command dialos will not be repeated. 

>[ We will now proceed throuah the normal startup command sequence. 

>SET /UIC=C2r543 
>INS *PIP/INC»1B000 

>P I P C200 , 200 3SYSGEN . CMD/RE/NV=S YSGEN . CMD 

>pip lb: ti , ukitident.dat/ap=lb: tz, 54 3 instalog.dat 



>SET /UIC=C200,2003 

>[ PLEASE NOTE 

:>? If you have not yet read the system reiease notes do so now before 
>'t attemptina to perform a 5YSGEN or utilize the new features of 
'■>': this system. 

>CON ONLINE ALL 
>RUN ERRLOG 

ERL — ERROR LOG INITIALIZED 
>5TART/Gu'EUE/HANAGER 

'•INS *GMGPRT/TASK=PRT. . ./5LV=N0 

OS : 05: 33 GMG — UNEXPECTED EXIT PROCESSOR LPPO 
>INITIALIZE/QUEUE LPQO 

09:05:35 GMG — UNEXPECTED EXIT PROCESSOR BAPO 
INI — QUEUE ALREADY EXISTS 

> INITIALIZE/ PROCESSOR LPPO /FLAG : 2/F0RM : 0/LOWER 
INI — DEVICE OFFLINE 
MNITIALIZE/PR0CES50R BAPO 

INI — *WARNING* — ACCOUNTING NOT ACTIVE OR NOT INSTALLED 

>ASSIGN/QUEUE PRINT LPPO 

ASS — PROCESSOR DOES NOT EXIST 

>A5SIGN/QUEUE BATCH BAPO 

>@ <EOF> 

>@C200,2003sysaen 

>' RSX-1 1M-PLUS SYSGEN BLB 

>; 

>i COPYRIGHT (C) 1979, 1980 

>; DIGITAL EQUIPMENT CORP. , MAYNARD MA., 01751 

>; 

>SET /UIC=C200,2003 
>TIM 

09:08:39 09-DEC-81 

>; 

>? EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EVERY STEP IN THIS 
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>; SYSGEN COMMAND FILE. ON THE OTHER HAND, SHORT COMMENTS 
>■ PROVIDE VIRTUALLY HQ EXPLANATORY TEXT. 

> ; 

•INS LB.'C3,543MAC8IG/INC = 20000 

>INS LB: t3,34 3LBR/INC»20000 

>INS LB: C3.54 3TKB8ia/INC-20OO0 

> INS LB:t3,S4]EDI 

•INS LB:C3,543VMR 

>INS LB:C3,543FLX/INC«20000 

>• DO YOU WANT EXPANDED COMMENTS? CY/NKn 

>* ENTER DEVICE-UNIT OF RELEASE DISK i DDU : I CS R:2-3:: dr: 

>ASN dr:=IN: 

>asn dr: »ou: 

>ASN dr: «3Y: 
>ASN dr: »lb: 
>ASN dr:«WK: 
>ASN dr."=TK: 
>ASN dr:«BC: 
>ASN dr>Li: 

>asn dp:«o»: 

>ASN dr: *EX: 
>ASN dr: -hp: 

>* DO YOU WANT TO APPLY AUTOPATCH < <ESC> FOR DETAILS )? ZV/Nlly 

>• ENTER THE DEVICE-UNIT OF THE DRIVE ON WHICH THE AUTOPATCH TAPE 
>; KIT IS LOADED OR "SY:" IF THE AUTOPATCH KIT HAS ALREADY 
>; BEEN READ FROM THE DISTRIBUTION MEDIA. 

> ■ 

>» AUTOPATCH KIT DEVICE CSi: mm.' 

•SET /UIC'Cl, 1 1 3 

>; 

>; THE PREVIOUS CONTENTS OF THE AUTOPATCH WORK DIRECTORY ARE NOW PURGED 

> r 

>pip lb: r i , u ]«.«;»/de/nw 

>; 

>; READ THE AUTOPATCH COMMAND FILE FROM THE AUTOPATCH TAPE 

> ; 

>* IS mm: WRITTEN AT 1600 BPI? CY/NKn 
>MOU mi»:/F0R/DENS-800 

>BRU/REW/N0INIT/BAC:AUT0PATCH/DENS:800 ami SY: 
BRU - STARTING TAPE 1 ON MHO : 

BRU - END OF TAPE 1 ON MMO : 

BRU - COMPLETED 

>SET /UIC=C200,200J 
3 IP [ 200, 2003 /NV* CI. 1UAUT0PATCH.CMD 

>; 

>; Autopateh IE OCTOBER, 1931 

>; 

>; Crests the FORTRAN lntirfict Routine 
>;: object File UFD 

>UFD dr:C32.203 

>; 

>; Create the SYSLIB abject file UFD 
-UFD dr: [33.203 

>; 

>; Copy the updated Filet to dr.' 

>; 

>BRU /REWIND/NO INI T/SUPERSEDE/BAC: UPDATES mml dr: 
BRU - STARTING TAPE 1 ON MMO : 
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BRU - END OF TAPE 1 ON MMO ". 



BRU - COMPLETED 



>SET /UIOC1 , 1 J 

>; insert the updated Fi It system object files into SYSLIB 

*> r 

>PIP FCS.0BS/Ny-C50rZ0]*.0BJ 
>LBR SYSLIB/RP=FCS.OBS 
MODULE "CONTRL" REPLACED 



MODULE "PNTMRK" REPLACED 



>PIP FCS.OBSJO/DE 

>; 

>; Insert the updated FORTRAN Interface Routine object files into SYSLIB 

>; 

>PIP FIR.0BS/NV«C32,Z0]*.0BJ 
>LBR SYSLIB/RP=FIR.OBS 
MODULE " . CNMRK " REPLACED 

MODULE ".DSCKP" REPLACED 



MODULE " .ENAST" REPLACED 

MODULE " . ENCKP " REPLACED 

MODULE " . INAST" REPLACED 

MODULE "SPSUB " REPLACED 

MODULE " .WFLOR" REPLACED 



>PIP FIR.OBS;0/DE 

>; 

>i Insert the updated SYSLIB object files into SYSLIB 

>; 

>PIP SLB.0BS/NV=E55, 203*. OBJ 
>LBR SYSLIB/RP=SLB.OBS 
MODULE "OVCTR " REPLACED 



MODULE "*SUPL " REPLACED 

MODULE "*SUPL " REPLACED 

>PIP SLB.OBSSO/DE 

>LBR SYSLIB/RP-QIOSYM.OBJ/SS 

MODULE "QIOSYM" REPLACED 



>; insert the updated macro files in RSXMAC.SML 

>; 

>LBR RSXMAC.SML/RP=MACRO.MCS 
MODULE "SCAL*S" REPLACED 



MODULE "VSDA* " REPLACED 



>PIP MACRO. MCS=»/DE „ rt 

>* DO YOU WISH TO COPY THE CORRECTION AND PATCH FILES TO dr.? CY/N3. y 

>• 

>? Create any necessary UFDs 

>; 

>UFD dr : C24,B03 
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>UFD dr:C32,603 
>UFO dr:C33,603 
>UFD dr:C34,603 
>UF0 dr:C36.i03 
>UFD dr:C43,S03 
>UFD dr.' £52,803 
>UFD dr:CB2,603 
>UFD dr:C70,603 
>UFD dr:ci0S,S03 
>UFD dr:cil7,S03 
>UFD dr." [200,603 
>", 

>' Copy the correction and patch Filet to dr : 

>; 

• >BRU /REW/NOINIT/NEW_VERSION/BAC: CORRECTIONS mm: dr: 
BRU - STARTING TAPE 1 ON MHO : 

BRU - END OF TAPE 1 ON MHO: 

BRU - COMPLETED 

>♦ DO YOU WISH TO PAUSE TO COPY OR EDIT ANY CORRECTION FILES? CY/N3:n 

>; 

>; APPLICATION OF THE AUTOPATCH IS COMPLETE. A RECORD OF THIS 
>? WILL BE APPENDED TO THE KITIDENT FILE. 

>; 

>SET /UIC=C1,13 
>DHO mm: 

DMO — TTO: DISMOUNTED FROM MMO: *«« FINAL DISMOUNT *#* 
09:21.'50 *#* MMO : — DISMOUNT COMPLETE 

>SET /UIC»C200,2003 

># DO YOU WANT TO DO SYSGEN PART 1 (ASSEMBLE THE EXEC}? CY/N3.'n 

>• DO YOU WANT TO DO SYSGEN PART 2 (BUILD THE EXEC AND PRIV TASKS ) ? CY/N3:n 

>* DO YOU WANT TO DO SYSGEN PART 3 (BUILD UTILITY TASKS)? CY/N3:n 

>ASN = 
>B <EOF> 

> 



>uf d dr:C12,23 
>set /uic«C12,23 



>»ou »*:/for 

>f 1 x /rt»M«:pMonopy.OMd/do 

> 

>8p«ioncpy 

>* IS SOURCE DEVICE A MAGTAPE? EY/Ni:y 

>* IS DESTINATION DEVICE A MAGTAPE? CY/N3 : 

>* ENTER SOURCE DEVICE (DDN: > [S3: mm: 

>* ENTER DESTINATION DEVICE (DDN:) [S3 : dr: 

>* IS dr: MOUNTED? CY/N3:y 

>; 

>; PLEASE SPECIFY THE GROUP AND MEMBER NUMBERS OF THE SOURCE KIT DIRECTORY. 
>? THE ORIGINAL KIT DISTRIBUTION IS IN DIRECTORY [12,23. 

> r 

>* ENTER GROUP NUMBER OF SOURCE KIT DIRECTORY [0 R: 1-377 D:i23: 
>* ENTER MEMBER NUMBER OF SOURCE KIT DIRECTORY CO R! 1-377 D.*23: 

>' PLEASE SPECIFY THE GROUP AND MEMBER NUMBERS OF THE DIRECTORY TO WHICH 
>J THE SPM-11M-PLUS KIT FILES WILL BE COPIED. 
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>* ENTER GROUP NUMBER OF TARGET DIRECTORY CO R:i~3773: 12 
>♦ ENTER MEMBER NUMBER OF TARGET DIRECTORY CO RI 1-3773 1 2 
>SET /UIC=C12»23 

>FLX dr.' /RS=»M*: C 12, 2 3SMPGEN.CMD, SPM. DOC/DO 

>FLX dr:/RS/-RW»««i: C 12 , 23HKMAC . MAC , PMONSLP . CMD/DO/-RW 

>FLX dr." /RS/-RW-HM I 1 12 , 23SGNPER . COR , DRCRV . COR/DO/-RW 

>FLX dr : /RS/-RW=«« : C 1 2 , 23DRDSP . COR , DREIF . COR , DREXP . COR/DO/-RW 

>FLX dr : /RS/-RW=mm; C 1 2 , 23DRGIN . COR r DRQIO . COR , DRTBL . COR/DO /~RW 

>FLX dr : /RS/-RW»«i* : C 12 , 23LOWCR . COR , SYSCM . COR/DO/-RW 

>FLX dr : /RS/-RW-«.i» : C 12 , 23REGSB . COR , LOADR . COR/DO/-RW 

>FLX dr :/RS/-RW«»»: r 12,23 IOSUB. COR, 5YSXT. COR, TDSCH.COR/DO/-RW 

>FLX dr I /RS/-RW«m* : C 12 , 23 PMONPAT . CMD , D I SPAT . PAT/DO/-RN 

>FLX dr : /RS/-RH = «in : C12,23C0L . OLB , COLBLD . ODL , PMONBLD . CMD/DO/-RW 

>FLX dr: /C0/RS/BL:S0./-RW««im:C12,23CLF.T8K/D0/-RW 

>FLX dr: /CO/RS/BL : 73 . /-RW-mm : C12,230VL . TSK/DO/-RW 

>FLX dr: /CO/RS/BL : 175. /-RW»«m: C 12.23DRS.TSK/D0/-RW 

>FLX dr : /RS/-RW««m : t 12 , 230VL . MAP , OVL . OLB/DO/-RW 

f>FLX dr : /RS/-RW -mm :C12,23 CLF .MAP, DRS . CMD , MDRTKB . CMD/DO/-RW 

>FLX dr : /RS/-RW«*i>t : C 1 2 , 23MDREIS . OLB . MDRFPP . OLB , DRS . MAP/DO/-RW 

>* APPLY CORRECTIONS TO EXECUTIVE SOURCES? CY/N3 : r 

>INS «SLP 

>SET /UIC»C200,2003 

>PIP RSXMCO . MAC/AP« C12, 23HKMAC . MAC 

>SLP 8C12,23SGNPER.C0R 

>SET /UIC*C1 1 ,103 

>SLP 8C12,23DRCRV.C0R 

>SLP 8C12,23DRDSP.C0R 

>SLP 8C12,23REQSB.C0R 

>SLP @C12,23SYSXT.COR 

>SLP @C 12, 23DREIF.CDR 

>SLP 8C12.23DREXP.CDR 

>SLP BC12,23L0ADR.C0R 

>SLP @C12,23DRGI0.C0R 

>SLP 8C12, 23I0SUB.CDR 

>SLP 8C12, 23SYSCM.CDR 

>SLP 8C12,23L0WCR.C0R 

>SLP 8C12,23DRTBL.C0R 

>SLP 8C12,23DRGIN.C0R 

>SLP BC12,23TDSCH.COR 

>REM ...SLP 

>; **- NOTE -»* 

>', 

>, DO NOT APPLY THE FOLLOWING PATCH TO FUACP IF YOU ARE GOING 

>; TO SELECT THE FCPR03 (DEFAULT) F11ACP AT SY8GEN. 

>; 

>* APPLY PATCH TO F11ACP DISPATCHER MODULE (DISPAT)? CY/N3 : y 

>INS *PAT 

>SET /UIC=C12,23 

>MAC DISPAT. POB«=HKMAC . MAC , DISPAT . PAT 
>LBR DISPAT. OBJ J 1 * C 1 » 24 3 FCP/EX : DISPAT 

>PAT DISPAT.0BJ,2-DISPAT.0BJ,1/CS:044214,DISPAT.P0B/CS:017664 

>* WAS THE CHECKSUM SUCCESSFUL? CY/N3 : y 

>SET /UIC=C1 ,243 

>LBR FCP/RP«C12,2 3DISPAT.OBJ,-2 

MODULE "DISPAT" REPLACED 

>REM ...PAT 
>SET /UIC«=C12,23 
>B <EOF> 
>dmo mm: 

DMO ~ TTO: DISMOUNTED FROM MMO ". *** FINAL DISMOUNT »♦* 
09:41:19 ♦** MMO \ — DISMOUNT COMPLETE 

> 
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> 



>t«t /ulc«t200,2003 
>Ss y f sin 

>," RBX-UM-PLUS SYSGEN BLB 

>; 

>', COPYRIGHT (C) 1979, 1980 

>; DIGITAL EQUIPMENT CORP. r MAYNARD MA., 01734 

>; 

>SET /UIC»C200,2003 
>TIM 

09 ."42; 23 08-DEC-81 

>; 

>: EXPANDED COMMENTS PROVIDE A DESCRIPTION OF EMERY STEP IN THIS 
>; SYSGEN COMMAND FILE. ON THE OTHER HAND, SHORT COMMENTS 
>; PROVIDE VIRTUALLY NO EXPLANATORY TEXT. 

K 

>♦ DO YOU WANT EXPANDED COMMENTS? CY/NKn 

>» ENTER DEVICE-UNIT OF RELEASE DISK CDDU.'3 CS R:2-53." dr: 

>ASN <Jr:«IN: 
>ftSN dr.*«OU: 
>ASN dr:«SY: 
>ASN dr:«LB: 
>ASN dr>WK: 
>ASN dr.*«TK: 
>ASN dr>BC: 
>ASN dr:»LII 
>ASN dr:»OB: 
>ASN dr>EX: 
>ftSN dr>MP: 

>* DO YOU WANT TO APPLY AUTOPATCH < <ESC> FOR DETAILS )? EY/N3.'n 
>• DO YOU WANT TO DO SYSGEN PART 1 (ASSEMBLE THE EXEC)? EY/NKy 

>; 

>; RSX-11M-PLUS SYSGEN PART 1 < VERSION 1.0> 

>; 

>; DETERMINE SYSTEM FEATURES AND ASSEMBLE THE EXECUTIVE 

>; 

>* HAVE YOU ALREADY RUN SGN? CY/N3 In 
>SET /UIC=C1 1 ,243 

>pip in:«.obj;*/de/nm,*.tty;*,*.obs;* 

>SET /UIC«C1,243 

>pip inicii ,io3RSXMc.mac;*/de/nm,systb;# 
>pip i n : c 1 1 , 24 3 rbxa8m . cmd ; */de/nm 

>PIP INI CI, 243R8XBLD.CMD ;*/de/nm, dsphm.cmd;*, ldrum.cmd;*, rsxum.cmd:* 
>pip in: ci,243diriim. cmd ;*/de/nm, dircom.cmd;*, DIR. CMD ;* 

>SET /1JIC=E200,2003 

>PIP RSXMC.SAV/PU/NM, SQNSYM.CMD 

>; 

>; START SGN — VERSION 06.00B 

>; 

>i BEGIN PART A OF SYSGEN PHASE 1 

>; 

>; 

>: EXPANDED COMMENTS RESULT IN THE DISPLAY OF EXPLANATORY TEXT 

>; PRECEDING EACH QUERY. SHORT COMMENTS OMIT THE TEXT. EXPANDED 

>; COMMENTS ARE AVAILABLE ON A PER QUERY BASIS BY ENTERING ESCAPE 

>J OR ALTMODE FOLLOWING THE DISPLAY OF THE QUERY. FOR QUESTIONS 

>', THAT CONTAIN A RANGE SPECIFICATION, AN ANSWER THAT FALLS 

>•> WITHIN THE RANGE MUST PRECEDE THE ESCAPE. THIS ANSWER WILL 

>? HAVE NO EFFECT ON THE QUESTION WHEN IT IS ASKED AGAIN. 

>; 

>' TO EXIT FROM THE SGN INDIRECT FILES AT ANY TIME, TYPE CNTRL/Z. 

>? 

>,■ IF YOU ARE UNSURE OF THE ANSWER TO A QUESTION FOR WHICH A DE- 

>: FAULT ANSWER EXISTS, USE THE DEFAULT ANSWER. 
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>; 

>* LONG DIALOGUE DESIRED FOR EXECUTIVE/PROCESSOR OPTIONS? CY/NKn 
>« DO YOU WANT THE STANDARD FULL-FUNCTIONALITY EXECUTIVE? CY/N3 t r 
>* ASSEMBLY LISTING FILES DESIRED? CY/NK r 

># WHAT IS TO BE THE LISTING DEVICE? C DDU : 3 CS R:2-3K dr : 
>* SPOOL LISTING FILES? tV/NKn 

>; 

>J THE TASK BUILDER MAP OF THE EXECUTIVE WILL BE SAVED ON THE SYSTEM DISK. 

>; 

>r BEGIN EXECUTIVE SERVICE OPTIONS . 

>; 

>* DO YOU WANT DECNET SUPPORT? CY/NKn 

>* ARE YOU PLANNING TO INCLUDE A USER WRITTEN DRIVER? CY/NKn 

>* DO YOU WANT TO INCLUDE THE EXECUTIVE DEBUGGING TOOL ( XDT ) ? CY/NK v 

>« ENTER CRASH NOTIFICATION DEVICE CSR ADDRESS CO R: 1BOOOO-177700 0:1775643 

># ON WHAT DEVICE DO YOU WISH CRASH DUMPS TO BE WRITTEN CDD: 3 CS R:2-3K mm 

>* WHAT IS THE PHYSICAL UNIT NUMBER OF THE CRASH UNIT CO R:0-7 D:OK 

>; 

>; END EXECUTIVE SERVICE OPTIONS. 

>; 

>: BEGIN PROCESSOR OPTIONS. 

>; 

>* ENTER MEMORY SIZE (1024 WORD BLOCKS) CD R: 128. -1 920 . 01256. K 320 

>* DO YOU WANT FLOATING POINT PROCESSOR SUPPORT? CY/NK y 

>* IS YOUR SYSTEM CLOCK PROGRAMMABLE (KW1 1-P>? CY/NKn 

>* IS YOUR LINE FREQUENCY 30 HERTZ? CY/NKn 

>? 

>r END PROCESSOR OPTIONS. 

>', 

>', END PART A OF SYSGEN PHASE i 

>; 

>* DO YOU WANT TO CONTINUE WITH PART B OF THIS SGN? CY/NK y 

>; 

>) WE WILL NOW CONTINUE WITH PART B OF SYSGEN PHASE 1 

>; 
>; 

>i BEGIN PERIPHERAL OPTIONS. 

>; 

>* EXPANDED COMMENTS DESIRED FOR PERIPHERAL OPTIONS? CY/NKn 
>* HOW MANY RH CONTROLLERS DO YOU HAVE CO R:o-17 DI4K 2 

>; 

>* HOW MANY RP04/05/06 DISK PACK DRIVE UNITS DO YOU HAVE? CO R:0-77K 

>; 

>* HOW MANY RM02/03/05 DISK DRIVE UNITS DO YOU HAVE? CO R:0-77K 2 
>* ARE ANY OF THE UNITS DUAL-ACCESS? CY/NKn 

>; 

>• WHAT IS THE PHYSICAL UNIT NUMBER OF DRO: £0 R:0-7 D:OK 

>* TO WHICH RH CONTROLLER IS DRO I CONNECTED CSK A 

># ENTER THE DISK TYPE FOR DRO I < RM02 , RM03 , RM03 ) CSK r»03 

>; 

>* WHAT IS THE PHYSICAL UNIT NUMBER OF DRK CO RIO-7 DZIK 

>* TO WHICH RH CONTROLLER IS DR1 '. CONNECTED CSK A 

>* ENTER THE DISK TYPE FOR DRi: ( RM02 . RM03 . RM05 ) CSK r«o\o\03 

>; 

>* HOW MANY RS03/04 DISK DRIVE UNITS DO YOU HAVE? CO R:0-77J : 

>; 

>• HOW MANY TU1B/45/77/TE16 TAPE UNITS DO YOU HAVE? CO R:0-1003 : 1 
>* HOW MANY MASTER DRIVE UNITS ARE THERE COK 1 

>; 

># WHAT IS THE PHYSICAL UNIT NUMBER OF MHO I £0 R:0-7 D:OK 
>* TO WHICH RH CONTROLLER IS MMO." CONNECTED CSK B 

>; 

>; THE AVAILABLE SLAVE UNITS HAVE ALREADY BEEN ALLOCATED TO OTHER 
>i MASTER DRIVES. MASTER DRIVE MMO I IS THEREFORE ASSUMED TO HAVE 
>? NO SLAVE DRIVE UNITS ATTACHED TO IT. 
>: 
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>* ENTER THE VECTOR ADDRESS OF RHA [0 R: 60-774 DC234K 

>* WHAT IS ITS CSR ADDRESS CO R 1 60000-1 77700 D." 1767003 : 

>* ENTER THE VECTOR ADDRESS OF RHB CO R:S0-774 DI2243 : 

>• WHAT IS ITS CSR ADDRESS CO R : 1 60000- 1 77700 D: 1724403.' 

>* HOW MANY RK11 CARTRIDGE DISK CONTROLLERS DO YOU HAVE? CO] '. 

>* HOW MANY RKG11 DISK CARTRIDGE CONTROLLERS DO YOU HAVE? COK 

>* HOW MANY RP11-C/E DISK PACK CONTROLLERS DO YOU HAVE? tOK 

>* HOW MANY CM/CR11 CARD READERS DO YOU HAVE? C03." 

>* HOW MANY TA11 DUAL CASSETTES DO YOU HAVE? COK 

>• HOW MANY RL1 1 DISK CARTRIDGE CONTROLLERS DO YOU HAVE? COK 

>♦ HOW MANY TS11 MAGTAPE CONTROLLERS DO YOU HAVE? COK 

>* HOW MANY TCI 1 DECTAPE CONTROLLERS DO YOU HAVE? COK 

># HOW MANY RX11 DISK CONTROLLERS DO YOU HAVE? COK 

>* HOW MANY RX211 DISK CONTROLLERS DO YOU HAVE? COK 

>* HOW MANY TU58 CONTROLLERS 00 YOU HAVE? COK 

># HOW MANY LP/LS/LV11/LA1B0 LINE PRINTERS DO YOU HAVE? COK 

>* HOW MANY TM/TMA/TMB 1 1 MAGTAPE CONTROLLERS DO YOU HAVE COK' 

>* HOW MANY PC11 PAPER TAPE READER/ PUNCHES DO YOU HAVE? COK 

>* HOW MANY PR1 1 PAPER TAPE READERS DO YOU HAVE? COK Q 

>* HOW MANY LPA11-K LAB SUBSYSTEMS DO YOU HAVE? CD RZO.-IB.K 

>* HOW MANY IP113 INDUSTRIAL CONTROL SUBSYSTEMS DO YOU HAVE? COK 

>* ENTER NUMBER OF ADDITIONAL DL1 1 LINE INTERFACES CO R."0-10 DCOK 

>♦ ENTER TERMINAL TYPE FOR YLA (DEFAULT* LA3G) CSK 

>* ENTER NUMBER OF DHU ASYNCHRONOUS LINE MULTIPLEXERS CO R: 0-20 3 .' 
>* ENTER NUMBER OF DJii ASYNCHRONOUS LINE MULTIPLEXERS CO R:0-203: 
>♦ ENTER NUMBER OF DZli ASYNCHRONOUS MULTIPLEXERS CO R:0-403 : 2 
>* DO ANY OF THE LINES REQUIRE MODEM SUPPORT? CY/N3 : y 
>» AT WHICH BAUD RATE DO YOU WANT TO ANSWER? CS3 " 300 

>; 

>* ENTER VECTOR ADDRESS OF YZA CO RI300-7743: 300 

>* WHAT IS ITS CSR ADDRESS? CO R.' 1G0000-1777003 : 180070 

>* HOW MANY LINES DOES IT HAVE? CD R.'l .-8. DIB. 3: 

>* ENTER TERMINAL TYPE FOR YZA (DEFAULT- VT52 > CS3 ' VT100 

>; 

>• ENTER VECTOR ADDRESS OF YZB CO R:300-7743 : 310 

>* WHAT IS ITS CSR ADDRESS? CO R : 1 60000- 1 77700 3 : 160100 

>* HOW MANY LINES DOES IT HAVE? CD R.'l. -8. D:8.3: 

>* ENTER TERMINAL TYPE FOR YZB (DEFAULT- VT52 ) CS3 ". VT100 

>* DO YOU HAVE ANY INTER-COMPUTER COMMUNICATION DEVICES? CY/N3In 

>; 

>; END PERIPHERAL OPTIONS. 

>; 

>PIP RSXMC . MAC "RSXMC . SAV , RSXMC . TMP , RSXMCO . MAC 

>PIP RSXMC. TMP J*/DE 

>SET /UIC«C1 ,543 

>PIP C 1 , 34 3 /RE/NV- C 200 , 200 3 VMRTTY . CMD 

>SET /UIC=C1 ,243 

>PIP Cll, 103 /RE= C 200 , 200 3 RSXMC . MAC ; * , SYSTB . MAC ; * 

>PIP Cll ,24]/RE«C200, 2003R5XASM.CMD 

>PIP CI , 24 3 /RE/NM- C200 , 200 3 RSXBLD . CMD , RSX 1 1 M . CMD , DSP 1 1 M . CMD , LDR 1 1M.CMD 

>PIP CI ,243/RE- C200.2003DIR11M.CMD, DIRCOM.CMD, DIR. CMD 

>* DO YOU WISH TO PAUSE TO EDIT ANY OF THE SGN OUTPUT FILES? CY/N3 '. 

>SET /UIC«=C11,243 

>rm 

OS : 35: 22 OB-DEC-BI 

;>MAC 8in:rsxasm 

>TIM 

10:23:54 03-DEC-81 

>PIP RBX.OBS-*.OBJ 

>PIP RSX 1 1M.0B J /RE-RSX . OBS 

>PIP TTDRV . OBS»* . TTY 

>SET /UIC=C200,2003 

>PIP 0U:/NV»IN:C11, 103RSXMC.MAC 

>SET /UIC=C1 ,243 

>pip int rsxbld. cmd/ pu/nm 
>pip in:rsxhm.olb;*/de/nm 
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>PIP C200,2003RSXMC.MAC/PU/NM 

i >LBR IN:RSX11M/CR:25S. : 1800. :256.-0U: C11,Z43RSX11M.0BJ 
>LBR IN: TTDRU/CR : 40. : 332 . : 128 . -0U : C 1 i , 243TTBRV . DBS 

>; 

>' END SYSGEN PHASE 1 

>; 

>* DO YOU WANT TO DO SYSGEN PART 2 (BUILD THE EXEC AND PRIM TASKS ) ? CY/N3: r 

>; 

>-, IF YOU HAVE ALREADY DONE A SYSGEN ON THE TARGET DISK - A 
SYSTEM MAY RESIDE IN CI, 543. YOU HAY WANT TO SAME THAT 
>,' SYSTEM. 

>; 

># HAVE YOU DONE A SYSGEN ON THE TARGET DISK BEFORE? CY/NKn 

>; 

>; RSX-l 1M-PLU8 SYSGEN PART 2 <VERSION 1 ,0> 

>; 

>r BUILD THE EXECUTIVE AND ALL PRIVILEGED TASKS 

>: 

>* HAVE YOU ALREADY BUILT THE EXEC? EY/NKn 

>SET /UIC-C1 ,243 

>TIM 

10:33:20 03-DEC-81 
>TKB fRSXBLD 
>TIM 

10:35:04 09-DEC-81 

># DO YOU WANT TO CONTINUE AND BUILD THE TASKS NOW? lY/W.y 
>SET /UIC=C1 ,243 

># WHAT FCP DO YOU WANT < DEFAULT = FCPR03 ) ? 152'. FCPR02 

>* DO YOU NEED TO EDIT ANY OF THE BUILD COMMAND FILES? CY/NKn 

>SET /UIC*C1 ,343 

>PIP SYSVMR.CMD* VMRTTY.CMD/AP 

># DO YOU WANT TO EDIT SYSVMR.CMD? CY/NKn 

> ' 

NOW WE BUILD THE PRIVILEGED TASKS AND LOADABLE DRIVERS 

y 1 

>asn nl:=mp: 

>* do you want the maps of the privileged tasks? cy/nkn 

>SET /UIC=E200,2003 

>; 

>* MAPS OF THE DRIVERS WILL BE SAVED ON THE SYSTEM DISK 

>; 
>; 

>; IF ANY OF THE DRIVERS YOU ARE BUILDING HAVE A LOADABLE DATA BASE, 
>• YOU NEED TO EDIT THE FILE DRIVERS. BLD TO ADD THE NAME OF 
>; YOUR DATA BASE MODULE AFTER THE NAME OF YOUR DRIVER MODULE. 

>; 

>; for example: 

>; 

>; *pl lb:xxdrv 

>; sy:u ,24 3rsxiim/lb:xxdrv 

>; »af :>:xtab 

>; sy: ci ,243rsxi im/lb:xxdrv:xxtab 

>; *ed 

>; 

>» DO YOU NEED TO EDIT DRIVERS. BLD? CY/NKn 

>SET /UIC=C1,243 

>TKB 8 C 200, 200 j DPI VERS. BLD 

>PIP SY: Cl ,34 3TTC0M.TMP;*/DE/NM 

>SET /UIC=C200,200j 

>; 

>; BLDDRV SAVES THE COMMAND FILE USED TO BUILD THE DRIVER(S) 
>■ IN £200,2003, AND NAMES IT DRIVERS. BLD 

>; 

>TIM 

10:3S: 52 09-DEC-81 
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>TK8 BACCBLD 
>TKB BACNBLD 
>TKB BACSBLD 
>TKB 8B00BLD 
>TKB 8BPRBLD 
" fKB BBROBLD 
>TKB 8BYEBLD 
>TKB BCOTBLD 
i >TKB 1DCLBLD 
,>TKB 8DCLDSPBLD 
>TKB BDMOBLD 
>TKB iERFBLD 
>TKB BERLFSLBLD 
>TKB 8FCPR02BLD 
*>TKB BFXRBLD 
>TKB BF11MSGBLD 
>TKB BHELFSLBLD 
>TKB flHRCBLD 
>TKB 8INDFSLBLD 
, >TKB 8INIBLD 



>TKB BMCRBLD 
>TKB 8MCRDSPBLD 
>TKB 8M0UBLD 
>TKB iMTABLD 
>TKB tPMDFSLBLD 
>TKB iQMGFSLBLD 
>TKB BRMDBLD 
>TKB BSAVBLD 
>TKB 8SHABLD 
>TKB BSHFBLD 
>TKB 8SHTBLD 
>TKB fSYLFSLBLD 
>TKB 8TKNBLD 
>TKB 8UFDBLD 
>TKB SUNLBLD 
>TIM 

u : ib:si os-dec-si 
>asn lb:«ou: 

>SET /UIC=C1 ,343 

>asn lb:«sy: 

>pip ou:rsxiim.sys/co/nm/bl:438.=in:rsxiih.tsk 
>vmr bsybvmr 



LOADING EXECUTIVE DATA SPACE 
DATA SPACE LOADING COMPLETED 

VMR — INSTALLED TASKS OR COMMONS MAY NO LONGER FIT IN PARTITION 

SET /top»fcppar:-* 

vmr — installed tasks or commons may no longer fit in partition 
set /top-drvpar:-* 

syspar 026320 00202500 00012000 main 

ldrpar 026234 00214500 00003000 main 

02*644 00214500 00003000 task c...ldr3 

fcppar 026210 00217500 00051500 main 

secpol 026040 00271200 00010000 sec pool 

drvpar 025774 00301200 00074200 main 

025730 00301200 00001400 driver ( rd : > 

0236s4 00302600 00001300 driver cvt: ) 

023620 00304100 00000100 drimer ( nl : ) 

025554 00304200 00003100 drimer (co: ) 

023310 00307300 00004600 driver (mm: ) 

025444 00314100 00004700 driver (dr: ) 

025400 00321000 00035400 RW COM ! TTCOn ! 

025314 00336400 00017000 DRIVER (TT: ) 
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EXAMPLE INSTALLATION 



H-13 



5 



GEN 


025250 


00375400 02002400 


MAIN 






. . . LDR 


09.01 


025060 


LDRPAR 


248 


. 00003000 


lbo: 


-00156234 


TKTN 


03. IB 


1 13160 


SYSPAR 


248 


. 00010000 


lbo: 


-00161016 


. . . RMD 


MO. 01 


114220 


GEN 


225 


. 00025300 


lbo: 


-00161554 


FUMSG 


MOO 11 


116110 


GEN 


200 


. 00040000 


lbo: 


-00157424 


MTAACP 


0010 


114534 


GEN 


200. 00013500 


lbo: 


-00161445 


SHE . . . 


01.02 


113600 


GEN 


200 


. 00013500 


lbo: 


-00160607 


. . . DCL 


0113A 


116740 


GEN 


160 


. 00040000 


lbo: 


-00157636 


DCL. . . 


01 13A 


116634 


SYSPAR 


160 


. 00010000 


lbo: 


-00157451 


. . .DMO 


23.02F 


116530 


GEN 


160 


. 00040000 


lbo: 


-00157006 


. . .MCR 


01 .01 


115050 


GEN 


160 


. 00040000 


lbo: 


-00161127 


MCR. . . 


3.3 


114744 


SYSPAR 


160. 00010000 


lbo: 


-00161327 


. . .MOU 


23.03 


1 14640 


GEN 


160 


. 00040000 


lbo: 


-00160500 


F11ACP 


M0320 


026104 


FCPPAR 


149 


00051500 


lbo: 


-00157347 


COT. . . 


00.02 


117044 


GEN 


145 


. 00015700 


lbo: 


-00156756 


ERRLOG 


05 


116320 


GEN 


145 


00016200 


lbo: 


-00157126 


HRC. . . 


02 


115700 


GEN 


140 


00053400 


lbo: 


-00160422 


PMD . . . 


3. 1 


114430 


GEN 


140 


00023700 


lbo: 


-00160530 


SYSLOG 


01 .01 


113264 


GEN 


130 


00020400 


lbo: 


-00162070 


SHF. . . 


03.01 


113474 


SYSPAR 


105 


00010000 


lbo: 


-00160635 


FXR. . . 


01 


116214 


GEN 


100. 00003100 


lbo: 


-00157147 


... INI 


20.01 


115470 


GEN 


100 


00040000 


lbo: 


-001G0644 


. . . 1 \r 


4 


1153G4 


GEN 


100 


00030000 


lbo: 


-00157578 


. . . SAM 


04.38 


114114 


GEN 


100 


00040000 


lbo: 


-00161704 


. . . UFD 


M0410 


113054 


GEN 


100 


00040000 


lbo: 


-00160722 


BAPO 


01 .01 


1 17464 


GEN 


80 


00043000 


lbo: 


-00157157 


OMG. . . 


01 .04 


114324 


GEN 


75. 


00027000 


lbo: 


-00160556 


LPPO 


1 .OSA 


115154 


GEN 


70. 


00014200 


lbo: 


-00161037 


. . .ACC 


01.01 


024524 


GEN 


65. 


00036700 


lbo: 


-0015G527 


. . . AT. 


04.27 


115574 


GEN 


65. 


00057700 


lbo: 


-00157525 


. . . SHA 


01.01 


114010 


GEN 


65. 


00025500 


lbo: 


-00161762 


. . .ERF 


04 


1 16424 


GEN 


61. 


00040000 


lbo: 


-00157024 


SHC. . . 


01 .01 


1 13704 


GEN 


60. 


00051700 


lbo: 


-00161363 


ACNT 


3 


024420 


GEN 


50. 


00055700 


lbo: 


-00157033 


■ • ■ ACS 


01 . 1 


1 17674 


GEN 


50. 


00040000 


lbo: 


-00156634 


. . .BOO 


04. 12 


117570 


GEN 


50. 


00040000 


lbo: 


-0015E654 


. . . BRO 


M3A 


U73G0 


GEN 


50. 


00031200 


lbo: 


-0015G703 


. . .BYE 


01 .93 


1 17254 


GEN 


50. 


00014400 


lbo: 


-0015G737 


. . . CON 


01.01 


117150 


GEN 


50. 


00123200 


lbo: 


-00040355 


. . . HEL 


01 .25 


116004 


GEN 


50. 


00030200 


lbo: 


-00157472 


. . .LOA 


03.3 


1 15260 


GEN 


50. 


00040000 


lbo: 


-001G0740 


SHUTUP 


02.01 


1 13370 


GEN 


50. 


00010700 


lbo: 


-001G0707 


. . . UNL 


03.4 


112750 


GEN 


50. 


00040000 


lbo: 


-00162113 


RHA 


OFL 


CPA 


CSR = 


176700 MEC»254 PRI=5 


RHB 


OFL 


CPA 


CSR' 


172440 MEC-224 PRI*5 


YLA 


OFL 


CPA 


CSR = 


177560 MEC=SO 


PRI=5 


Y2A 


OFL 


CPA 


CSR = 


160070 MEC=300 PRI=5 


Y2B 


OFL 


CPA 


CSR = 


160100 VEC=310 PRI=5 


dro: 


rhao: 




OFL 




DRIVER 






dri : 


RHA 1 : 




OFL 




DRIVER 






mmo: 


rhbo: 




OFL 




DRIVER 






coo: 






OFL 




DRIVER 






tto: 


ylao: 




OFL 




DRIVER 






tti: 


yzao : 




OFL. 




DRIVER 






TT2: 


YZA i : 




OFL 




DRIVER 






TT3 1 


YZA2 : 




OFL 




DRIVER 






TT4.' 


YZA3 : 




OFL 




DRIVER 






TT5 : 


YZA4 : 




OFL 




DRIVER 






ttb: 


YZA5 : 




OFL 




DRIVER 






TT7 : 


yzag: 




OFL 




DRIVER 






ttio: 


YZA7 : 




OFL 




DRIVER 






tti i : 


yzbo: 




OFL 




DRIVER 






TT12: 


YZB1 : 




OFL 




DRIVER 






TT13! 


YZB2 : 




OFL 




DRIVER 






TT14: 


Y2B3I 




OFL 




DRIVER 






ttis: 


YZB4: 




OFL 




DRIVER 
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EXAMPLE INSTALLATION 



H-14 



TTiS: YZB5.' OFL DRIVER 

TT17! YZBS: OFL DRIVER 

TTZO: YZB7 I OFL DRIVER 

NLO: OFL DRIVER 

MTO: OFL DRIVER 

RDO: ONL DRIVER 
POOL* 1 200 : 1 3428. : 13444. ."2025 

>* DO YOU WANT TO DO SYSGEN PART 3 (BUILD UTILITY TASKS)? CY/NKn 
>ASN = 
>@ <EOF> 

xM° ^ ' 54]r,><1 1b 

XDT> 

RSX-UM-PLUS V01 BL6 



> 

TIM li:30 9-DEC-B1 
>TIM 

11 :30:02 09-DEC-81 
>SAV /WB/NOCON 



rsx-1 1m-plus v01 bls 320k 
>red dr:=sy: 
>red dr:»lb: 
>red dr:=sp: 
>mou dr.-rsx11mpbl6 

>iDR:tl,23STARTUP 

>: PLEASE NOTE 

>; 

>J If you haue not ytt read the system release notes do to now before 
>"■ attempt ina to perform a SYSGEN or utilize the new features of 

> I this system. 
>" 

>* Please enter time and date (HHIMM MM/DD/YY) LSI". 11:31 

>* Please enter tiMe and date (HHIMM MM/DD/YY) [S3 : 1K31 12/9/81 

>TIME 11131 12/9/81 

>ACS SY:/BLKS=1024. 

>CON ONLINE ALL 

>RUN ERRLOG 

ERL -- ERROR LOG INITIALIZED 
> START /QUEUE/ MANAGER 

> (' 
>INS *BMGPRT/TASK = PRT ... /SLV-NO 

li:3i:07 QMG ~ UNEXPECTED EXIT PROCESSOR BAPO 

>INITIALIZE/GUEUE LP0O 

INI — QUEUE ALREADY EXISTS 

>ST ART /ACCOUNTING 

MNITXALIZE/PROCESSOR LPPO/FLAG : 2/FDRM : 0/LOWER 

INI — DEVICE DOES NOT EXIST > 

> INITIALIZE /PROCESSOR BAPO 

>ASSIGN/QUEUE PRINT LPPO 

ASS — PROCESSOR DOES NOT EXIST 

>ASSIGN/QUEUE BATCH BAPO to 
>e <EOF> 
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EXAMPLE INSTALLATION 



H-15 



>SET /UIC 

UIC=C12,Z1 

XPKONBLD 

>* ENTER KW11-P VECTOR ADDRESS CO R! 100-774 D: 1043 : 
># ENTER KWU-P CSR ADDRESS CO R : 1S0000-1 7777B D: 1723403 : 
>* WILL THE BUFFERS BE IN A STATIC PARTITION? CY/NKn 
>TKB iCOLBLD 
>TKB BTRMBLD 
' >TKB BCOLMSQBLD 

>; 

>; Tat Kbuild the MDR > OML & CLF Proiram. 

>; 

># EIS or FPP <FPP> LSI 1 eis 

>; you Must specify either "EIS" or "FPP" without the Quotes 

>* EIS or FPP <FPP> CS3 : EIS 

>: 

>♦ Do you wish to build the tasK OML? CY/Nl In 

>; 

>* Do you wish to build the task CLF? t Y/N3 In 

>; 

>* Do you wish to build the tasK MDR? C Y/N3 '. y 

>* Build Overlaid Version of HDR.TSK? CY/N3 :n 

>* Do you want to edit the MDR taiKbuild command file? C Y/NJ 

>TKB BMDREISNOV 

>8 <EOF> 

> 
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EXAMPLE INSTALLATION 



( ) 



